Deployment

RoomZ wird als Docker-Image ausgeliefert. Updates werden automatisch erkannt und eingespielt.

Automatische Updates

Auf dem Server läuft ein Dienst, der alle 5 Minuten prüft, ob neue Versionen der RoomZ-Container verfügbar sind. Wenn ein Update erkannt wird, werden die betroffenen Container automatisch aktualisiert und neu gestartet.

Datenbankmigrationen werden beim Containerstart automatisch ausgeführt.

Manuelles Update

Falls Sie ein Update manuell anstoßen möchten:

# Neue Images herunterladen
docker compose pull

# Container mit neuen Images neustarten
docker compose up -d

Rollback

Bei Problemen nach einem Update:

1. Erstellen Sie vorher ein Datenbank-Backup (siehe Docker Setup)
2. Setzen Sie die Container auf die vorherige Version zurück:

docker pull <image>:<vorherige-version>
docker tag <image>:<vorherige-version> <image>:latest
docker compose up -d

WARNING

Bereits ausgeführte Datenbankmigrationen werden beim Rollback nicht automatisch rückgängig gemacht. Halten Sie immer ein aktuelles Backup bereit.

Umgebungsvariablen

Die wichtigsten Variablen werden in der .env-Datei konfiguriert:

Variable	Beschreibung
APP_KEY	Verschlüsselungsschlüssel
APP_URL	Öffentliche URL
DB_DATABASE	Datenbankname
DB_USERNAME	Datenbank-Benutzer
DB_PASSWORD	Datenbank-Passwort
MAIL_HOST	SMTP-Server
MAIL_PORT	SMTP-Port
MAIL_USERNAME	SMTP-Benutzer
MAIL_PASSWORD	SMTP-Passwort

Weitere Details: Konfiguration

SSL/TLS

SSL-Zertifikate werden über den Reverse Proxy (z.B. NGINX Proxy Manager) verwaltet. Let's Encrypt wird für die automatische Zertifikatserneuerung empfohlen.

Monitoring

Logs prüfen

docker compose logs -f

Scheduler-Status

Im Web-Portal unter Finanzen wird der Scheduler-Heartbeat angezeigt:

• Aktiv: Letzter Heartbeat vor weniger als 5 Minuten
• Inaktiv: Kein Heartbeat

Container-Status

docker compose ps

Erstinstallation

Eine vollständige Installationsanleitung finden Sie unter Installation.