TrueNAS SCALE¶
Haben läuft auf TrueNAS SCALE als eigene App aus einer Datei,
deploy/truenas/compose.yml, mit denselben
Images wie mit Docker Compose: App, Datenbank und das tägliche Backup, dazu der kurze
Dienst schluessel, der beim ersten Start die Schlüssel erzeugt. Du änderst darin nur eine Zeile, die Adresse.
Voraussetzungen¶
- TrueNAS SCALE 24.10 oder neuer; ältere Versionen nutzen für Apps noch Kubernetes statt Docker.
- Ein Reverse Proxy mit HTTPS und eine Domain, etwa die App Nginx Proxy Manager aus dem Katalog. Ohne HTTPS funktionieren Passkeys und die Installation als App nicht.
App installieren¶
- Apps › Discover Apps › Custom App › Install via YAML, Name
haben. - Den Inhalt von
deploy/truenas/compose.ymleinfügen und in der ZeileBETTER_AUTH_URLdeine Adresse eintragen, mithttps://, etwaBETTER_AUTH_URL: https://haben.example.de. Passkeys hängen an dieser Adresse; später nicht mehr ändern. - Speichern. Der erste Start lädt die Images, das dauert ein paar Minuten.
Ist Port 3000 schon belegt, änderst du die linke Zahl in 3000:3000 und nimmst sie auch im Proxy.
Für getrennte Datenbankrollen legst du die App-Rolle vorher selbst an.
Trage unter app.environment DATABASE_URL für den App-Zugang und MIGRATION_DATABASE_URL für den Eigentümerzugang zur
selben Datenbank ein. Der bisherige Eigentümerzugang verwendet das erzeugte db-passwort aus dem Volume schluessel.
Bleiben beide Werte leer, startet Haben unverändert mit diesem Zugang.
Schlüssel sichern¶
Apps › haben › Workloads: Das Log des Containers haben-schluessel zeigt ENCRYPTION_KEY und RESTIC_PASSWORD.
Trag beide in deinen Passwortmanager ein, bevor du weitermachst.
Wichtig
Ohne ENCRYPTION_KEY lassen sich ELSTER-Zertifikat und gespeicherte Zugangsdaten nach einer Wiederherstellung nicht mehr
öffnen, ohne RESTIC_PASSWORD ist das Backup wertlos. Beide liegen sonst nur auf dem Server selbst.
Reverse Proxy¶
Im Proxy einen Eintrag für deine Domain anlegen, Ziel IP-DES-SERVERS, Port 3000, mit einem Let's-Encrypt-Zertifikat.
Er muss Uploads bis 250 MB annehmen und bis zu 300 Sekunden auf eine Antwort warten; die Einträge für Nginx Proxy Manager
und andere stehen unter Eigener Reverse Proxy. Port 3000 gibst du im Router nicht frei.
Konto anlegen¶
Im Log des Containers haben-app steht nach „Listening on …“ der Einrichtungscode. Ruf deine Adresse auf, gib ihn ein und
leg dein Konto an; weiter geht es in Erste Schritte. ERiC für ELSTER lädst du unter
Einstellungen › ELSTER › ERiC per Knopf herunter, siehe ERiC einbinden.
Backup¶
Der Container haben-backup sichert Datenbank und Belege jeden Tag um 03:15 Uhr mit restic in das Volume backups auf
demselben Server. Gegen den Verlust des Servers trägst du in der App (Edit) bei RESTIC_REPOSITORY ein zweites System
ein, für S3 dazu AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY, siehe
Repository auf einem zweiten System.
Ein Backup von Hand, etwa vor einem Update: in der Shell des Containers haben-backup (Workloads) backup.sh
ausführen.
Zum Wiederherstellen in System › Shell:
sudo docker stop haben-app
sudo docker exec -it haben-backup restore.sh latest
sudo docker start haben-app
Was dabei passiert, steht unter Wiederherstellen.
Updates¶
Erst ein Backup von Hand wie oben, dann unter Apps › haben mit Update bzw. Pull Images die aktuellen Images holen. Migrationen laufen beim Start der App, siehe Updates.
Letztes Update: