Zum Inhalt

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

  1. Apps › Discover Apps › Custom App › Install via YAML, Name haben.
  2. Den Inhalt von deploy/truenas/compose.yml einfügen und in der Zeile BETTER_AUTH_URL deine Adresse eintragen, mit https://, etwa BETTER_AUTH_URL: https://haben.example.de. Passkeys hängen an dieser Adresse; später nicht mehr ändern.
  3. 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: