diff --git a/README.md b/README.md index e872870..a5f85ac 100644 --- a/README.md +++ b/README.md @@ -146,7 +146,7 @@ Auf einem frischen Server kannst du die Betriebsdateien und die Konfiguration di curl -fsSL https://git.federspiel.tech/flfeders/FEDEO/raw/branch/dev/scripts/selfhost-install.sh | bash ``` -Der schnelle One-Liner mit direktem Stack-Start: +Der One-Liner von der Webseite nutzt den schnellen Standardpfad und startet den Stack direkt: ```bash curl -fsSL https://git.federspiel.tech/flfeders/FEDEO/raw/branch/dev/scripts/selfhost-install.sh | bash -s -- --simple --start @@ -491,17 +491,41 @@ Wenn der Bootstrap aktiviert ist, kannst du dich danach mit `FEDEO_BOOTSTRAP_ADM ## Updates -Bei neuen Versionen: +Script-installierte Instanzen liegen standardmassig unter `/opt/fedeo`. Ein Update besteht daraus, die Selfhost-Dateien zu erneuern, die vorgebauten Images zu ziehen und den Compose-Stack neu zu starten. + +Vor kritischen Updates sollte ein Backup der persistenten Daten erstellt werden: ```bash +cd /opt/fedeo +tar -czf "backup-$(date +%Y%m%d-%H%M%S).tar.gz" .env postgres minio +``` + +Danach die aktuellen Selfhost-Dateien laden und den Stack aktualisieren: + +```bash +cd /opt/fedeo curl -fsSL https://git.federspiel.tech/flfeders/FEDEO/raw/branch/dev/docker-compose.selfhost.yml -o /opt/fedeo/docker-compose.yml curl -fsSL https://git.federspiel.tech/flfeders/FEDEO/raw/branch/dev/.env.example -o /opt/fedeo/.env.example curl -fsSL https://git.federspiel.tech/flfeders/FEDEO/raw/branch/dev/scripts/selfhost-setup.sh -o /opt/fedeo/scripts/selfhost-setup.sh chmod +x /opt/fedeo/scripts/selfhost-setup.sh +docker compose --env-file /opt/fedeo/.env -f /opt/fedeo/docker-compose.yml pull docker compose --env-file /opt/fedeo/.env -f /opt/fedeo/docker-compose.yml up -d ``` -Der Backend-Container wendet Datenbankmigrationen beim Start automatisch an. Bei kritischen Updates sollte vorher ein Backup von `./postgres` und `./minio` erstellt werden. +Der Backend-Container wendet Datenbankmigrationen beim Start automatisch an, solange `FEDEO_RUN_MIGRATIONS` nicht deaktiviert wurde. Falls Migrationen manuell erzwungen werden sollen: + +```bash +docker compose --env-file /opt/fedeo/.env -f /opt/fedeo/docker-compose.yml run --rm backend npm run migrate +docker compose --env-file /opt/fedeo/.env -f /opt/fedeo/docker-compose.yml up -d +``` + +Anschliessend den Zustand prüfen: + +```bash +docker compose --env-file /opt/fedeo/.env -f /opt/fedeo/docker-compose.yml ps +curl -I https://app.example.com +curl https://app.example.com/backend/health +``` Die Selfhost-Compose-Datei nutzt vorgebaute Images. Dadurch braucht der Server keinen Repository-Checkout und keine lokalen Build-Kontexte.