Coolify¶
Coolify startet Haben aus einer Datei,
deploy/coolify/compose.yml: App, Datenbank
und das tägliche Backup mit denselben Images wie mit Docker Compose. Die Schlüssel
erzeugt Coolify beim Anlegen, Domain und HTTPS übernimmt sein Proxy statt des mitgelieferten Caddy.
Dienst anlegen¶
- Im Projekt + New › Docker Compose wählen und den Inhalt von
deploy/coolify/compose.ymleinfügen. - Beim Dienst
appdie Domain eintragen, mithttps://, etwahttps://haben.example.de. Ohne eigene Domain vergibt Coolify eine eigene; Passkeys hängen an der Domain, deshalb vor dem ersten Start festlegen. - Deploy. Im Log von
appsteht nach „Listening on …“ der Einrichtungscode. Ruf die Domain auf, gib ihn ein und leg dein Konto an; weiter geht es in Erste Schritte.
Die übrigen Einstellungen aus Umgebungsvariablen, etwa ERIC_AUTO_INSTALL=ja oder
die KI-Auslesung, trägst du unter Environment Variables ein. ELSTER geht nur auf einem Server mit Intel- oder
AMD-Prozessor, siehe ERiC einbinden.
Für getrennte Datenbankrollen legst du die App-Rolle vorher selbst an und
setzt unter Environment Variables DATABASE_URL auf den App-Zugang und MIGRATION_DATABASE_URL auf den
Eigentümerzugang zur selben Datenbank. Bleiben beide Werte leer, nutzt Haben den bisherigen Eigentümerzugang mit dem von
Coolify erzeugten SERVICE_HEX_64_POSTGRES.
Schlüssel sichern¶
Unter Environment Variables stehen die erzeugten Werte. Zwei davon gehören zusätzlich in deinen Passwortmanager:
| Variable in Coolify | entspricht | wofür |
|---|---|---|
SERVICE_REALBASE64_ENCRYPTION |
ENCRYPTION_KEY |
ELSTER-Zertifikat und gespeicherte Zugangsdaten |
SERVICE_REALBASE64_RESTIC |
RESTIC_PASSWORD |
das Backup |
Ohne sie ist nach dem Verlust des Servers das Backup wertlos. Ändere keinen der erzeugten Werte, nachdem Haben einmal lief.
Lange Uploads¶
Der Proxy von Coolify ist Traefik. Er bricht eine Anfrage nach 60 Sekunden ab; ein großer Upload über eine langsame
Leitung endet dann mit Fehler 502. Unter Server › Proxy in der Konfiguration bei command diese Zeile ergänzen und den
Proxy neu starten:
Backup¶
Der Dienst backup sichert Datenbank und Belege jeden Tag um 03:15 Uhr in das Volume backups auf demselben Server.
Gegen den Verlust des Servers trägst du unter Environment Variables bei RESTIC_REPOSITORY ein zweites System ein,
für S3 dazu AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY, siehe
Repository auf einem zweiten System.
Ein Backup von Hand, etwa vor einem Update: im Terminal von Coolify den Container backup wählen und backup.sh
ausführen.
Zum Wiederherstellen per SSH auf dem Server in den Ordner des Dienstes wechseln; die ID steht in der Adresse des Dienstes
in Coolify hinter /service/:
cd /data/coolify/services/<id>
docker compose stop app
docker compose run --rm restore latest
docker compose start app
Was dabei passiert, steht unter Wiederherstellen.
Updates¶
Erst ein Backup von Hand wie oben, dann den Dienst neu deployen; Coolify holt dabei die aktuellen Images. Migrationen laufen beim Start der App, siehe Updates.
Letztes Update: