Installation

Diese Anleitung beschreibt die Erstinstallation von RoomZ auf einem Server.

Voraussetzungen

• Linux-Server (Ubuntu 22.04+ empfohlen)
• Docker und Docker Compose installiert
• Eine Domain mit DNS-Eintrag auf den Server
• SSL-Zertifikat (z.B. über Let's Encrypt / NGINX Proxy Manager)

Schritt 1: Projektverzeichnis anlegen

mkdir -p /opt/roomz
cd /opt/roomz

Schritt 2: Umgebungsvariablen konfigurieren

Erstellen Sie eine .env-Datei mit den folgenden Pflicht-Variablen:

# Anwendung
APP_KEY=base64:...          # Mit `php artisan key:generate --show` erzeugen
APP_URL=https://ihre-domain.de

# Datenbank
DB_DATABASE=roomz
DB_USERNAME=roomz_user
DB_PASSWORD=<sicheres-passwort>
DB_ROOT_PASSWORD=<sicheres-root-passwort>

# E-Mail (SMTP)
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=noreply@example.com
MAIL_PASSWORD=<passwort>
MAIL_FROM_ADDRESS=noreply@example.com

Schritt 3: Container starten

docker compose up -d

Beim ersten Start wird automatisch:

• Die Datenbank initialisiert
• Alle Migrationen ausgeführt
• Der Storage-Link erstellt

Schritt 4: Setup-Wizard durchlaufen

Rufen Sie https://ihre-domain.de/setup im Browser auf.

Der Setup-Wizard führt Sie durch 9 Schritte:

1. Firmenname und Kontaktdaten
2. Erster Admin-Benutzer
3. Standort anlegen
4. Stockwerke definieren
5. Zimmer erstellen
6. Ausstattung festlegen
7. Ticketkategorien
8. Aktivitäten für Zeiterfassung
9. Abschluss und Zusammenfassung

Schritt 5: Reverse Proxy einrichten

Konfigurieren Sie Ihren Reverse Proxy (z.B. NGINX Proxy Manager), um HTTPS-Anfragen an den RoomZ-Container weiterzuleiten. Richten Sie ein SSL-Zertifikat ein (Let's Encrypt empfohlen).

Nächste Schritte

• Konfiguration – Umgebungsvariablen und Feineinstellungen
• Updates – Automatische und manuelle Updates