Server-Betrieb mit Docker (Tarif Pro)
XPARCEL als Docker-Stack im Heimnetz betreiben, im Browser und auf dem Smartphone nutzen. Voraussetzungen, Einrichtung, Zertifikat, Sicherung und Updates.
Im Tarif Pro lässt sich XPARCEL zusätzlich auf einem eigenen Server im Heimnetz betreiben, etwa auf einem NAS, einem Mini-PC oder einer virtuellen Maschine. Dann greifen mehrere Personen per Browser darauf zu, und Ablesung sowie Übergabeprotokoll funktionieren auf dem Smartphone. Den Zugang zur Server-Fassung erhalten Sie nach dem Kauf über den Support.
Voraussetzungen
| Bereich | Minimum | Empfehlung |
|---|---|---|
| Host | Linux mit Docker Engine 24+ und Docker Compose v2 | eigene VM oder Mini-PC, verschlüsselte Festplatte |
| CPU / RAM | 2 Kerne, 3 GB frei | 4 Kerne, 4 GB |
| Speicher | 10 GB | 50 GB und ein externer Speicher für Sicherungen |
| Netz | feste IP oder DNS-Name im Heimnetz | eigener Name, zum Beispiel immo.home.arpa, mit vertrauenswürdigem Zertifikat |
Einrichten
./scripts/setup.sh immo.home.arpa
Das Skript erzeugt alle Geheimnisse, die Konfiguration (.env), ein selbstsigniertes Zertifikat und das Schlüsselpaar für die Sicherungen, baut und startet den Stack und legt den ersten Eigentümer an. Danach öffnen Sie https://immo.home.arpa, melden sich an und richten den zweiten Faktor ein; im Server-Betrieb ist er Pflicht.
Den angezeigten privaten Backup-Schlüssel (
backup-private-key-….txt) sofort sicher offline ablegen und vom Server löschen. Nur mit ihm lassen sich Sicherungen wiederherstellen.
Zertifikat und Zugriff von unterwegs
Für Passkeys, die Kamera auf dem Smartphone und Kalender-Abos braucht der Server ein vertrauenswürdiges Zertifikat, etwa per Let’s Encrypt mit DNS-Challenge für eine eigene Domain oder mit einer eigenen Zertifizierungsstelle. Richten Sie keine Portfreigabe im Router ein; für den Zugriff von außen nutzen Sie ein VPN (WireGuard, Tailscale oder OpenVPN).
Betrieb
| Aufgabe | Befehl |
|---|---|
| Starten / Stoppen | docker compose up -d / docker compose down |
| Update mit Sicherung vorab | ./scripts/update.sh |
| Sofort sichern | docker compose exec api python -m app.cli backup |
| Wiederherstellen | ./scripts/restore.sh <sicherung.tar.age> <backup-private-key.txt> |
| Konto entsperren | docker compose exec api python -m app.cli unlock --email … |
| Zweiten Faktor zurücksetzen | docker compose exec api python -m app.cli reset-mfa --email … |
Sicherungen entstehen jede Nacht um 02:30 Uhr im Volume backups, verschlüsselt an den öffentlichen Schlüssel aus der Einrichtung. Kopieren Sie sie zusätzlich auf ein NAS oder einen externen Datenträger und üben Sie die Wiederherstellung einmal im Jahr.
Lizenz im Server-Betrieb
Unter Einstellungen → Lizenz aktivieren Sie den Schlüssel wie in der Windows-Fassung. Der Server braucht dafür ausgehenden Zugang zu https://api.xparcel.de, gegebenenfalls über einen Proxy (OUTBOUND_PROXY). Ziehen Sie den Server um, melden Sie vorher das Gerät ab.
Umzug zwischen Server und Windows
Eine Sicherung der Server-Fassung lässt sich in der Windows-Fassung bei der Einrichtung einspielen, zusammen mit dem privaten Backup-Schlüssel, siehe Sicherung und Umzug.