Update und Sicherung

Update

Punchify aktualisieren Sie mit zwei Befehlen im Installationsordner:

docker compose pull
docker compose up -d

Die Datenbank wird beim Start automatisch auf den neuen Stand gebracht. Was sich geändert hat, steht im Änderungsprotokoll (CHANGELOG) jeder Version. Wer kontrolliert aktualisieren möchte, trägt in .env eine feste Version ein (PUNCHIFY_VERSION=0.10.0) und erhöht sie bewusst.

Vor einem Update empfiehlt sich eine aktuelle Sicherung (siehe unten).

Sicherungen

Punchify sichert die gesamte Datenbank jede Nacht um 02:30 Uhr (Zeitzone der Instanz). Die Sicherungen sind mit AES-256-GCM verschlüsselt; der Schlüssel wird aus PUNCHIFY_SECRET_KEY abgeleitet. Die letzten 14 bleiben erhalten (PUNCHIFY_BACKUP_KEEP).

Die Dateien liegen im Container unter /data/backups (Docker-Volume punchify-data). Kopieren Sie sie regelmäßig auf ein anderes System – eine Sicherung auf demselben Server schützt nicht vor dessen Ausfall.

Sicherungen anzeigen und von Hand anlegen:

docker compose exec app python3 -m punchify.backup list
docker compose exec app python3 -m punchify.backup create

Eine Sicherung auf den Rechner holen (Beispiel):

docker compose cp app:/data/backups ./punchify-backups

Wiederherstellen

Das Zurückspielen ersetzt alle Daten der Installation durch den Stand der Sicherung.

docker compose exec app python3 -m punchify.backup restore /data/backups/<Dateiname>
docker compose restart app

Dafür muss PUNCHIFY_SECRET_KEY derselbe sein wie beim Anlegen der Sicherung. Eine Sicherung von einem anderen Server kopieren Sie vorher mit docker compose cp <Datei> app:/data/backups/ in den Container.

Umzug auf einen neuen Server

1. Auf dem alten Server eine Sicherung anlegen und herunterladen.
2. Auf dem neuen Server Punchify installieren – mit derselben .env (insbesondere PUNCHIFY_SECRET_KEY).
3. Sicherung in den Container kopieren und zurückspielen (siehe oben).
4. DNS auf den neuen Server umstellen.

Protokolle

docker compose logs app --tail 100
docker compose logs caddy --tail 100