Installation
Für den echten Betrieb führt ein Assistent durch die Installation. Er fragt zuerst alle Angaben ab, prüft den Server und zeigt eine Zusammenfassung. Erst wenn ihr bestätigt, wird etwas verändert. Wer erst schauen möchte, startet die Demo mit fiktiven Daten auf dem eigenen Rechner.
Aktuelle Version 3.2.0Release-Hinweise
Debian 13 nativ, Proxmox-LXC oder Docker Compose V2 auf einem Linux-System mit systemd.
Mindestens 2 GB Arbeitsspeicher und 5 GB freier Platz im Datenverzeichnis.
Ein DNS-Eintrag zeigt auf den Server. Für das eingebaute HTTPS sind die Ports 80 und 443 frei.
Per SSH als root oder mit sudo. Der Assistent prüft alles, bevor er etwas verändert.
Für die Demo reicht ein normaler Rechner mit Linux, macOS oder Windows mit WSL.
Läuft direkt auf dem Server, ohne Docker. Der Assistent installiert PostgreSQL, Redis, die Anwendung und Caddy für HTTPS selbst.
Auf einem frischen Debian 13 die Pakete installieren, die Git und der Assistent vorab brauchen.
sudo apt-get update
sudo apt-get install -y git jq curl openssl ca-certificatesArbeitet ihr direkt als root, lasst sudo einfach weg.
Den Release-Tag v3.2.0 auschecken. Installierbar sind nur veröffentlichte Versionen, keine Branches.
git clone --depth 1 --branch v3.2.0 https://github.com/Jugendfeuerwehr-Manager/JF-Manager.git
cd JF-ManagerEr lädt das Releasepaket 3.2.0 von GitHub und prüft Prüfsummen und Manifest, bevor er etwas installiert.
sudo ./ops/jfctl install --version 3.2.0 --mode nativeWeiter mit den Fragen des Assistenten und den Schritten danach.
JF-Manager läuft in Containern aus vorgebauten Release-Images. jfctl legt die Compose-Konfiguration an und verwaltet sie; ihr bearbeitet keine Compose-Datei von Hand.
Docker Engine mit Compose V2 nach der offiziellen Anleitung für euer System einrichten. Danach prüfen und die übrigen Werkzeuge installieren (Debian oder Ubuntu):
docker compose version
sudo apt-get install -y git jq curl openssl ca-certificatesDocker Desktop unter Windows oder macOS ist kein unterstützter Produktionsweg, weil jfctl systemd für Sicherungen und Wartung braucht. Zum Testen unter Windows nehmt ihr die Demo in WSL.
git clone --depth 1 --branch v3.2.0 https://github.com/Jugendfeuerwehr-Manager/JF-Manager.git
cd JF-ManagerEr lädt die Release-Images und prüft das Paket, bevor er etwas startet.
sudo ./ops/jfctl install --version 3.2.0 --mode composeLäuft auf dem Host schon eine ältere JF-Manager-Installation mit Compose, wählt mit --expert einen eigenen Projektnamen und folgt der Migrationsanleitung.
Weiter mit den Fragen des Assistenten und den Schritten danach.
Für Proxmox VE 9. Ein Skript auf dem Proxmox-Host legt einen unprivilegierten Debian-13-Container an und installiert JF-Manager darin. Auf dem Host selbst werden keine Anwendungsdienste installiert.
In der Shell des Proxmox-Hosts als root, nicht in einem Container:
apt-get install -y git
git clone --depth 1 --branch v3.2.0 https://github.com/Jugendfeuerwehr-Manager/JF-Manager.git./JF-Manager/ops/proxmox/jf-lxc.sh --version 3.2.0Das Skript fragt CT-ID, Hostname, Storage, CPU, RAM, Plattengröße (mindestens 8 GB), Netzwerkbrücke, IP-Adresse (DHCP oder statisch) und DNS ab, danach die Angaben des Assistenten. Es prüft Proxmox-Version, Storage und Debian-13-Vorlage sowie das Release, bevor es etwas anlegt.
Alle weiteren jfctl-Befehle laufen im Container:
pct enter <CT-ID>
jfctl statusWeiter mit den Schritten nach der Installation.
Startet JF-Manager auf eurem Rechner mit einer neuen, temporären Datenbank voller fiktiver Daten: drei Abteilungen, über 50 Mitglieder, Dienste, Übungen, Ausstattung, Eltern- und Mitgliederzugänge. Es werden keine echten E-Mails oder Push-Nachrichten verschickt, und die Demo ist nur auf eurem Rechner erreichbar.
Nur zum Ausprobieren. Die Demo ist keine Installation für echte Daten. Für den Betrieb nehmt ihr Debian, Docker oder Proxmox.
Gebraucht werden Git, Python 3.12 mit Pipenv und Node.js ab 22.12 (oder 20.19). So geht es unter Ubuntu 24.04, wo Python 3.12 schon dabei ist:
sudo apt-get update
sudo apt-get install -y git curl build-essential python3-dev libldap2-dev libsasl2-dev pipenv
# Node.js 22, die Ubuntu-Pakete sind dafür zu alt
curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt-get install -y nodejsDebian 13 bringt Python 3.13 mit; die Demo verlangt 3.12. Nehmt dafür Ubuntu 24.04 oder installiert Python 3.12 zusätzlich.
git clone --depth 1 --branch v3.2.0 https://github.com/Jugendfeuerwehr-Manager/JF-Manager.git
cd JF-Manager/backend
pipenv install
PIPENV_DONT_LOAD_ENV=1 pipenv run python demo.py --port 8011Das erste pipenv install dauert einige Minuten. Danach nennt das Terminal die Demo-Konten, ein gemeinsames Passwort und den Befehl für den aktuellen Anmeldecode. Lasst das Terminal offen.
In einem zweiten Terminal:
cd JF-Manager/frontend
npm ci
VITE_BACKEND_URL=http://127.0.0.1:8011 npm run devÖffnet http://localhost:5173 und meldet euch mit einem der angezeigten Konten und dem gemeinsamen Passwort an.
… manage.py demo_totp admin, im Ordner backend ausführen).mitglied@demo.example.invalid zeigt das Mitgliederportal.Beenden mit Strg+C in beiden Terminals. Jeder Start legt eine neue Demo-Datenbank an.
JF-Manager ist für Linux-Server gebaut. Unter Windows 10 und 11 läuft die Demo im Windows-Subsystem für Linux (WSL), das Microsoft kostenlos mitliefert. Die Oberfläche öffnet ihr ganz normal im Windows-Browser.
PowerShell als Administrator öffnen und ausführen. Danach den Rechner neu starten, Ubuntu aus dem Startmenü öffnen und einen Benutzernamen mit Passwort festlegen.
wsl --install -d Ubuntu-24.04Im Ubuntu-Fenster folgt ihr der Demo-Anleitung ab Schritt 1. Für das zweite Terminal öffnet ihr Ubuntu einfach ein zweites Mal.
Arbeitet im Linux-Heimatverzeichnis (cd ~) und nicht unter /mnt/c, sonst werden Installation und Start sehr langsam.
WSL leitet localhost an Windows weiter. Öffnet http://localhost:5173 in Edge, Chrome oder Firefox.
Den echten Installationsassistenten testet ihr unter Windows am besten in einer virtuellen Maschine mit Debian 13, etwa mit Hyper-V oder VirtualBox. Er braucht systemd und wird nur auf Debian 13 und Docker-Hosts unterstützt.
Debian, Docker und Proxmox
Für alle drei Serverwege gleich. Die Demo braucht davon nichts.
Danach prüft er Betriebssystem, Speicher, Arbeitsspeicher, Ports und DNS und zeigt eine Zusammenfassung. Nach eurer Bestätigung richtet er Pakete bzw. Images, Datenbank, Anwendung, Sicherung und Wartungs-Timer ein und legt das erste Administrationskonto an. Bricht ein Lauf ab, startet ihr denselben Befehl erneut; er setzt beim ersten offenen Schritt fort.
Wichtig: Am Ende zeigt der Assistent das Einmalpasswort für das Administrationskonto und den Ablageort des Backup-Passworts (/etc/jf-manager/backup.pass). Bewahrt das Backup-Passwort zusätzlich außerhalb des Servers auf, etwa in einem Passwortmanager. Ohne dieses Passwort lässt sich keine Sicherung lesen. Mehr zur Sicherung
jfctl ist jetzt fest installiert, den Git-Checkout braucht ihr danach nicht mehr. Prüft die Installation und ob sich die erste Sicherung vollständig lesen lässt:
sudo jfctl status
sudo jfctl doctor
sudo jfctl backup create
sudo jfctl backup verify latestSicherungen laufen danach täglich automatisch. Legt das Backup-Ziel auf ein anderes Gerät und probt die Wiederherstellung einmal auf einem Testsystem: Sicherung · Wiederherstellung · Regelbetrieb
Öffnet eure Domain und meldet euch mit dem Administrationskonto an. Beim ersten Login richtet ihr einen zweiten Faktor ein, per Passkey oder Authenticator-App, und ändert das Einmalpasswort. Organisation, Abteilungen, Rollen, E-Mail und SSO stellt ihr anschließend in der Weboberfläche ein.
Updates und Wiederherstellung
Ein Update braucht keinen neuen Checkout. jfctl lädt das Release, prüft es, legt vorher eine vollständige Sicherung an und wechselt erst dann. Scheitert ein Schritt, bevor die Oberfläche wieder freigegeben ist, kehrt es automatisch zur vorherigen Version zurück.
# Version aus den Release-Hinweisen einsetzen
sudo jfctl update --version X.Y.Z
# Sicherungen anzeigen und eine davon wiederherstellen
sudo jfctl backup list
sudo jfctl restore <backup-id>Für Fortgeschrittene
Ihr ladet das Paket direkt herunter und prüft die Prüfsummen selbst.
Releasepakete und HerkunftsnachweisVERSION=3.2.0
BASE=https://github.com/Jugendfeuerwehr-Manager/JF-Manager/releases/download/v$VERSION
curl -fsSLO "$BASE/jf-manager-$VERSION.tar.gz" -O "$BASE/SHA256SUMS" -O "$BASE/release-manifest.json"
sha256sum -c SHA256SUMS && tar -xzf "jf-manager-$VERSION.tar.gz"
sudo "./jf-manager-$VERSION/ops/jfctl" install --version "$VERSION" --release-dir .Für wiederholbare Installationen: alle Angaben in einer Datei, die nur root lesen darf.
Alle Schlüssel der Antwortdateisudo install -m 600 /dev/null /root/jf-answers.env
sudo editor /root/jf-answers.env
sudo jfctl install --answers /root/jf-answers.env --yesHinter einem vorhandenen Reverse Proxy wählt ihr im Assistenten bei HTTPS proxy und gebt Adresse und Port sowie die IP-Adresse des Proxys an. Produktionsvorgaben
Handbuch
Das Handbuch ist die verbindliche Referenz für Installation und Betrieb. Diese Seite fasst die üblichen Wege zusammen.