Unraid¶
Haben läuft auf Unraid als drei Container aus den Vorlagen in
deploy/unraid/: haben-db, haben und haben-backup,
mit denselben Images wie mit Docker Compose. In den Community Applications ist Haben
noch nicht; die Vorlagen holst du mit einem Befehl im Terminal.
Voraussetzungen¶
- Unraid mit aktiviertem Docker.
- Für ELSTER ein Server mit Intel- oder AMD-Prozessor, siehe ERiC einbinden.
- Ein Reverse Proxy mit HTTPS, etwa Nginx Proxy Manager, SWAG oder Traefik aus den Community Applications, und eine
Domain. Ohne HTTPS funktionieren Passkeys und die Installation als App nicht, und die Anmeldung ist nur unter der
Adresse möglich, die du in
habeneinträgst.
Vorbereiten¶
Im Terminal von Unraid (Symbol oben rechts):
docker network create haben
mkdir -p /mnt/user/appdata/haben/belege /mnt/user/appdata/haben/eric /mnt/user/appdata/haben/eric-log
chown -R 1000:1000 /mnt/user/appdata/haben/belege /mnt/user/appdata/haben/eric /mnt/user/appdata/haben/eric-log
for t in haben-db haben haben-backup; do
wget -qO /boot/config/plugins/dockerMan/templates-user/my-$t.xml \
https://raw.githubusercontent.com/firsttris/haben/main/deploy/unraid/$t.xml
done
echo "Datenbank-Passwort: $(openssl rand -hex 24)"
echo "AUTH_SECRET: $(openssl rand -base64 32)"
echo "ENCRYPTION_KEY: $(openssl rand -base64 32)"
echo "Backup-Passwort: $(openssl rand -base64 32)"
- Das Netzwerk
habenbrauchen die Container, um sich beim Namen zu finden; im Standardnetzbridgegeht das nicht. - Die App läuft als Nutzer 1000, nicht als
nobody(99) wie viele Unraid-Container. Ohnechownkann sie keine Belege speichern. - Die vier Werte am Ende brauchst du gleich in den Vorlagen.
ENCRYPTION_KEYund das Backup-Passwort gehören zusätzlich in deinen Passwortmanager: Ohne sie sind ELSTER-Zertifikat und gespeicherte Zugangsdaten nach einer Wiederherstellung verloren und das Backup wertlos.
Container anlegen¶
Unter Docker › Add Container die Vorlagen in dieser Reihenfolge wählen, ausfüllen und mit Apply starten:
| Vorlage | Eintragen |
|---|---|
haben-db |
Datenbank-Passwort |
haben |
Adresse mit https://, etwa https://haben.example.de (Passkeys hängen daran, später nicht mehr ändern). In DATABASE_URL das Wort DATENBANK-PASSWORT durch das Datenbank-Passwort ersetzen. AUTH_SECRET und ENCRYPTION_KEY |
haben-backup |
Datenbank-Passwort und Backup-Passwort |
Weitere Einstellungen wie ERiC oder die KI-Auslesung stehen in haben unter Show more settings.
Für getrennte Datenbankrollen legst du die App-Rolle vorher selbst an und
setzt in haben DATABASE_URL auf den App-Zugang. Unter Show more settings trägst du bei „Migrationsdatenbank“
(MIGRATION_DATABASE_URL) den Eigentümerzugang zur selben Datenbank ein. Wer den bisherigen Datenbankzugang beibehält,
lässt dieses zusätzliche Feld leer.
Reverse Proxy¶
Der Proxy leitet deine Domain an haben weiter: an haben:3000, wenn er im Netzwerk haben hängt, sonst an
IP-DES-SERVERS:3000. Er muss Uploads bis 250 MB annehmen und bis zu 300 Sekunden auf eine Antwort warten; die Einträge
für Nginx Proxy Manager, Traefik und andere stehen unter Eigener Reverse Proxy. Port 3000
gibst du im Router nicht frei.
Konto anlegen¶
Docker › haben › Logs zeigt nach „Listening on …“ den Einrichtungscode. Ruf deine Domain auf, gib ihn ein und leg
dein Konto an; weiter geht es in Erste Schritte.
Backup¶
haben-backup sichert Datenbank und Belege jeden Tag um 03:15 Uhr mit restic nach /mnt/user/appdata/haben/backups, also
auf denselben Server. Gegen den Verlust des Servers trägst du unter Show more settings bei RESTIC_REPOSITORY ein
zweites System ein, siehe Repository auf einem zweiten System.
Das Plugin Appdata Backup ersetzt das nicht: Es stoppt die Container und kopiert ihre Ordner, ohne Test-Restore.
Ein Backup von Hand, etwa vor einem Update: Docker › haben-backup › Console, dort backup.sh.
Zum Wiederherstellen im Terminal, mit deinem Datenbank- und Backup-Passwort:
docker stop haben
docker run --rm -it --net haben -e PGHOST=haben-db -e PGPASSWORD='…' \
-e RESTIC_REPOSITORY=/backups -e RESTIC_PASSWORD='…' \
-v /mnt/user/appdata/haben/belege:/belege -v /mnt/user/appdata/haben/backups:/backups \
--entrypoint restore.sh tristanteu/haben-backup:latest latest
docker start haben
Was dabei passiert, steht unter Wiederherstellen.
Updates¶
Erst ein Backup von Hand wie oben, dann unter Docker mit Check for Updates und apply update alle drei Container aktualisieren. Migrationen laufen beim Start der App, siehe Updates.
Letztes Update: