Get Started

Voraussetzungen

Vor dem Deployment solltest du Folgendes bereit haben:

• einen Linux-VPS mit installiertem Docker Engine und Docker Compose
• eine Domain, die du auf deinen Server zeigen lassen kannst
• Zugriff zum Anlegen von DNS-Eintraegen
• Zugriff, um dieses Repository auf dem Server zu klonen

Fuer produktive Nutzung solltest du einen Reverse Proxy mit HTTPS-Terminierung vor den App-Container setzen.

Installationsablauf

Im Projektverzeichnis auf deinem Server:

chmod +x scripts/selfhost-setup.sh
./scripts/selfhost-setup.sh

Das Setup-Skript sollte:

1. erforderliche Inputs und Umgebungswerte validieren
2. .env aus .env.selfhost.example erstellen, falls sie noch nicht existiert
3. den Stack mit Docker Compose bauen und starten

Wenn du Konfigurationswerte anpassen musst, aktualisiere deine .env und fuehre das Setup-Skript erneut aus.

Initiale Startup-Checks

Nach dem Setup pruefst du, ob die Container laufen:

docker compose ps

Danach kannst du die App-Logs verfolgen, bis die Anwendung als bereit gemeldet wird:

docker compose logs -f app

Fuer Datenbank-Diagnosen:

docker compose logs -f postgres

Erster Login und Signup

Sobald die App im Browser erreichbar ist:

1. Oeffne deine konfigurierte Domain.
2. Erstelle dein erstes Konto oder melde dich an.
3. Schließe Onboarding und initiales Company-Setup ab.

Nach dem ersten Login geht es weiter mit Installation verwalten fuer Updates, Restarts und Troubleshooting.