ProxLedger/docs/betrieb/inbetriebnahme.md

Inbetriebnahme

Der kürzeste Weg von null zu einem Dashboard, das Hosts meldet. Rechnen Sie mit einer halben Stunde.

Reihenfolge

Die Reihenfolge ist nicht beliebig – zwei Schritte hängen an der endgültigen Adresse:

1. Dashboard installieren
2. Adresse festlegen (Reverse Proxy, DNS)
3. OIDC einrichten (falls gewünscht)
4. Passkeys anlegen
5. Agents ausrollen

Wer Schritt 4 oder 5 vorzieht, macht sie nach einem Adresswechsel noch einmal: Passkeys gelten nur für die Domäne, unter der sie entstanden sind, und die Adresse steckt im Installations-Einzeiler.

1. Installieren

Docker (beliebiger Host mit Docker):

git clone https://git.wilde-server.de/florian.wilde/ProxLedger.git proxledger && cd proxledger
cp .env.example .env
# Pflicht: APP_SECRET, POSTGRES_PASSWORD, ADMIN_PASSWORD, APP_URL
docker compose up -d

LXC auf Proxmox, zwei Möglichkeiten:

bash deploy/lxc-installer.sh                    # Container mit Docker darin

# Nach Art der Proxmox VE Helper-Scripts, ohne Docker:
bash -c "$(curl -fsSL https://git.wilde-server.de/florian.wilde/ProxLedger/raw/branch/main/deploy/community-scripts/ct/proxledger.sh)"

Der erste Administrator entsteht beim Einrichten aus ADMIN_EMAIL und ADMIN_PASSWORD; beim LXC-Weg stehen die erzeugten Zugangsdaten in /opt/proxledger/.credentials.

APP_SECRET gehört sofort in die Sicherung. Er signiert die Sitzungen und verschlüsselt die gespeicherten Zugangsdaten für SMTP und Webhooks. Ohne ihn sind beide unbrauchbar.

2. Adresse festlegen

Siehe reverse-proxy.md. Danach unter Einstellungen → System die Adresse des Dashboards eintragen – sie landet im Installations-Einzeiler und in den Benachrichtigungen.

3. Anmeldung einrichten

• Optional OIDC: authentik.md
• Weitere Konten unter Einstellungen → Benutzer (Administrator, Techniker, Kunde)
• Jeder legt sich unter Meine Passkeys einen Passkey an – danach entfällt das Passwort

4. Agents ausrollen

1. Einstellungen → Agent-Tokens → Enrollment-Token erzeugen (mit Kundenbindung spart es den Zuordnungsschritt)
2. Auf jedem Proxmox-Host als root:

   curl -fsSL https://proxledger.firma.de/install.sh | bash -s -- --token <ENROLL_TOKEN>
   

3. In einem Cluster auf jedem Knoten – jeder Knoten hat eine eigene Subscription. Das Dashboard warnt von selbst, wenn ein Knoten fehlt.
4. Danach den Enrollment-Token widerrufen.

5. Benachrichtigungen

Einstellungen → Benachrichtigungen: SMTP-Zugang oder Webhook eintragen, Testnachricht schicken, Zusammenfassung auf täglich oder wöchentlich stellen.

Prüfliste

• https://…/api/gesundheit antwortet mit 200
• Anmeldung klappt, die Adresszeile bleibt auf der öffentlichen Adresse
• Ein Host meldet sich (Hosts zeigt ihn mit Ablaufdatum)
• Testnachricht ist angekommen
• Sicherung läuft und wurde einmal zurückgespielt (sicherung.md)
• APP_SECRET liegt an einem zweiten Ort