Updates und Backups

Panel aktualisieren

cd deploy
docker compose pull
docker compose up -d

• Das Panel wendet beim Start die Datenbank-Migrationen an. Mach vorher ein Backup (siehe unten), damit du zurück kannst.
• Gameserver laufen weiter: Sie laufen auf den Nodes, nicht im Panel. Die Agents verbinden sich innert Sekunden neu.
• Installierte Apps auf Handys holen die neue Version beim nächsten Start.

Agents aktualisieren

Hole auf jedem Node das Image des Agents und erstelle seinen Container neu:

docker compose -f compose.agent.yml pull
docker compose -f compose.agent.yml up -d

Der Node behält seine Identität, und der Agent übernimmt die laufenden Gameserver wieder.

Beides aktualisieren

Panel und Agents sprechen ein versioniertes Protokoll. Ändert es sich, wird ein Agent der anderen Version abgewiesen (protocol_mismatch), und sein Node erscheint offline, bis auch der Agent aktualisiert ist. Aktualisiere zuerst das Panel, dann die Agents.

Panel sichern

Zwei Dinge, die zusammengehören:

1. Die Datenbank: Benutzer, Tenants, Server, Einstellungen sowie die verschlüsselten Secrets und ihre Schlüssel.
2. Der Master-Key (keys/master.key): Er entschlüsselt die Schlüssel in der Datenbank. Ein Datenbank-Backup ohne ihn lässt sich zwar zurückspielen, aber Steam-Passwörter und geheime Variablen sind dann nicht mehr lesbar, und alle müssen sich neu anmelden.

cd deploy
docker compose exec -T postgres pg_dump -U panel -d panel -Fc > panel-$(date +%F).dump

Bewahre die Dumps und keys/master.key an verschiedenen Orten auf: Wer beides hat, kann die Secrets lesen.

Wiederherstellen

1. Starte eine leere Datenbank: docker compose up -d postgres
2. Spiele den Dump ein:

   docker compose exec -T postgres pg_restore -U panel -d panel --no-owner < panel-2026-10-15.dump

3. Lege denselben keys/master.key an seinen Platz und starte das Panel: docker compose up -d

Die Nodes verbinden sich von selbst wieder; ihre Identität steht in der Datenbank.

Was auf den Nodes liegt

Das Backup des Panels enthält die Dateien der Gameserver nicht. Sie liegen auf den Nodes, in /var/lib/panel-agent:

Ordner	Inhalt
servers/	die Dateien der Gameserver
backups/	im Panel erstellte Server-Backups
console/	Konsolen-Logs
agent.json	die Identität des Nodes (neues Registrierungs-Token: eine neue)

Server-Backups bleiben auf dem Node, auf dem sie erstellt wurden. Für Kopien an einem anderen Ort sicherst du /var/lib/panel-agent/backups/ mit deinen üblichen Werkzeugen (restic, Borg, Sync auf ein NAS); Kopien nach S3 oder auf ein NAS direkt aus dem Panel sind geplant.