Zum Inhalt

Installation

Am schnellsten über Docker Compose — hannah-core ist darin bereits enthalten und läuft standardmäßig mit. Die native Installation auf dieser Seite brauchst du nur, wenn du bewusst kein Docker willst.

Native Installation

Core hat ein eigenes deploy/install.sh im hannah-Repo:

curl -fsSL https://raw.githubusercontent.com/NurPech/hannah/master/core/deploy/install.sh | sudo bash
  • Lädt das aktuelle Release vom Update-Server, installiert es als systemd-Service (hannah.service), laufend unter einem eigenen hannah-System-User
  • Installationsverzeichnis: /opt/hannah/core
  • Config: /etc/hannah/config.yaml

Zum Deinstallieren (Config bleibt erhalten) braucht es keinen erneuten Download — das Script liegt bereits im Installationsverzeichnis:

sudo bash /opt/hannah/core/deploy/install.sh --uninstall

Beim ersten Lauf legt das Script noch keine config.yaml an — die liegt als Vorlage schon mit im Release, direkt im Installationsverzeichnis. Kopieren, anpassen, Dienst starten:

sudo cp /opt/hannah/core/config.example.yaml /etc/hannah/config.yaml
sudo nano /etc/hannah/config.yaml
sudo systemctl enable --now hannah

Prüfen, ob der Dienst wirklich läuft:

sudo systemctl status hannah
sudo journalctl -u hannah -f

status zeigt den aktuellen Zustand (läuft/abgestürzt/deaktiviert), journalctl -f folgt dem Log live — hier siehst du z. B. sofort, wenn die Config fehlerhaft ist.

Admin-Zugangsdaten stehen im Log

Beim allerersten Start (leere Datenbank) legt Core automatisch einen Admin-Account mit zufälligem Passwort an und gibt beides genau einmal hier aus — siehe Nutzerverwaltung → Erster Login.

Steuerbar über Umgebungsvariablen:

Variable Zweck Default
UPDATE_SERVER_URL Basis-URL des Update-Servers https://hannah-update.sgessinger.de
UPDATE_SERVER_TOKEN Bearer-Token des Update-Servers, siehe Update-Server nutzen. Ab dem 30.11.2026 Pflicht, bis dahin geht es noch ohne —
CORE_CHANNEL Release-Kanal core-stable

Automatisch aktuell halten

Optional — nur relevant, wenn du AutoDeploy einsetzt. Ohne AutoDeploy aktualisierst du Core, indem du das Install-Script erneut ausführst. Vorher den Sicherheitshinweis zu post_install lesen.

Den passenden Eintrag bekommst du am einfachsten im Config-Builder: Häkchen setzen, kopieren, fertig. Wenn du ihn lieber selbst einträgst, sieht er so aus:

  - name: core
    channel: core-stable
    install_dir: /opt/hannah/core
    service: hannah
    post_install: "/opt/hannah/core/venv/bin/pip install --upgrade -q -r /opt/hannah/core/requirements.txt"