Anleitungen
Erste Schritte
- Installation
- Server
- Paket-Repository (Pacman und APT)
- Kinderrechner (Linux)
- Kinderrechner (Windows)
- Einstellungen im WebUI
Betrieb
- Updates
- Backup und Wiederherstellung
- Aufbewahrung
- Umstieg auf PostgreSQL (einmalig)
- Deinstallation (Kinderrechner)
- Spiele (Steam, Heroic)
Sicherheit
Backup und Wiederherstellung
Auf dieser Seite
Der Server legt täglich ab 3 Uhr einen geprüften Dump der Datenbank an (pg_dump, komprimiert):
data/backups/kidctl-JJJJ-MM-TT-HHMM.dump. Die letzten 14 bleiben erhalten. Zeitpunkt und Größe des
letzten Backups stehen im WebUI unter Einstellungen, dort gibt es auch „Jetzt sichern“. Schlägt ein
Backup fehl oder gibt es seit 2 Tagen keines, kommt eine Push-Nachricht. Mit KIDCTL_MODE=saas sehen Eltern
diesen Bereich nicht (die Datenbank enthält alle Familien); den Stand zeigt dann der Verwaltungsbereich /admin,
ohne Download. Per Kommandozeile:
docker compose exec kidctl python -m app.cli backup.
Das externe Backup des Servers sollte ./data mitsichern, dann sind die Dumps dabei.
Wiederherstellen:
docker compose stop kidctl
docker compose exec -T db pg_restore --clean --if-exists -U kidctl -d kidctl < data/backups/kidctl-2026-11-16-0300.dump
docker compose start kidctl
Export und Import einer Familie
Unabhängig vom Datenbank-Backup kann der Inhaber unter Einstellungen → Daten der Familie alle Daten seiner Familie als ZIP exportieren (mit dem aktuellen Passwort): Kinder mit Regeln, Programmen und Web-Einstellungen, Geräte und ihre Benutzer, Nutzung, Protokoll und Chat – entschlüsselt und lesbar (JSON, mit Formatversion). Eltern-Accounts, Passwörter und Authenticator sind nicht enthalten.
So zieht eine Familie zwischen Self-Hosting und einem gehosteten Server um:
- Auf dem alten Server exportieren.
- Auf dem neuen Server ein Konto anlegen (Self-Hosting:
create-parent, gehostet: registrieren). Die Familie ist dann noch leer. - Dort unter Einstellungen → Daten der Familie die Datei importieren. Import geht nur in eine leere Familie.
- Die Computer der Kinder neu koppeln: Die übernommenen Geräte erscheinen als getrennt, weil ihre Kopplung nur auf dem alten Server gilt. Weitere Elternteile neu einladen.
Im gehosteten Betrieb kann der Inhaber dort auch die Familie löschen (mit Passwort und „LÖSCHEN“): Verbundene Agenten heben vorher alle Einschränkungen auf, dann werden der Schlüssel der Familie verworfen und alle Accounts und Daten gelöscht.
Auf GitHub bearbeiten · Quelle ist Deutsch; bitte beide Sprachen ändern.