KidCTL
Anleitungen

Erste Schritte

Betrieb

Sicherheit

Anleitungen · Betrieb

Updates

WasWie
Servergit pull && docker compose up -d --build. Datenbank-Migrationen (Alembic) laufen beim Start automatisch.
Umstieg SQLite → PostgreSQL (einmalig, Server bis 0.32.x)Siehe Umstieg auf PostgreSQL.
Verschlüsselung je Familie (einmalig)Vor git pull && docker compose up -d --build: Hauptschlüssel erzeugen (docker compose run --rm kidctl python -m app.cli master-key, mit dem alten Image geht es auch per python3 -c "import base64,os;print(base64.urlsafe_b64encode(os.urandom(32)).decode().rstrip('='))"), als KIDCTL_MASTER_KEY=… in .env eintragen und getrennt sichern. Beim Start verschlüsseln die Migrationen vorhandene Namen, Chats, Protokoll, Statistik und E-Mail-Adressen. Ohne Schlüssel startet der Server nicht.
Client-Paketepkgver in packaging/arch/PKGBUILD und agent/kidctl_agent/__init__.py erhöhen, committen und auf main pushen, dann kidctl-release.sh --apply (Paket-Repository) (Arch-, .deb- und Windows-Pakete aus derselben Version). Die Kinderrechner bekommen das Update mit sudo pacman -Syu bzw. sudo apt upgrade; Windows-Rechner installieren es selbst.
Ab 0.27.0Das SDDM-Theme steckt jetzt im Paket kidctl-plasma. Auf bestehenden Plasma-Rechnern einmalig sudo pacman -Syu kidctl-plasma, sonst fehlt der Hinweis im Anmeldebildschirm.

Ein Server-Update vor den Agenten ist unproblematisch, weil der Server auch die vorherige Protokollversion unterstützt. Zu alte Agenten markiert das WebUI.

Ist im Repository eine neuere Agent-Version als auf einem Rechner, zeigen Übersicht, Geräteliste und Geräteseite „Update: alt → neu“. Ist das Paket seit einem Tag veröffentlicht und der Rechner immer noch nicht aktualisiert, kommt einmalig eine Push-Nachricht.

Auf GitHub bearbeiten · Quelle ist Deutsch; bitte beide Sprachen ändern.