Files

T

florian.wildeandClaude Opus 5 b6fdd4f64a docs(betrieb): Einrichtung Schritt fuer Schritt dokumentieren (#029 )

Vier Anleitungen unter docs/betrieb/: Inbetriebnahme in der richtigen
Reihenfolge, HTTPS mit nginx Proxy Manager sowie netbird als privates Netz,
OIDC mit authentik samt Fehlerbildern, und Sicherung einschliesslich
Zurueckspielen.

Beim Aufschreiben zwei Fehler gefunden, die nur hinter einem Reverse Proxy
auftreten: Die OIDC-Rueckkehradresse uebersah die im Dashboard eingetragene
Adresse, und beim Einloesen des Codes wurde die interne Adresse verwendet -
der Anbieter haette den Tausch abgelehnt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-19 00:51:16 +02:00

2.9 KiB

Raw Blame History

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:

Dashboard installieren
Adresse festlegen (Reverse Proxy, DNS)
OIDC einrichten (falls gewünscht)
Passkeys anlegen
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 <repo> 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>/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

Einstellungen → Agent-Tokens → Enrollment-Token erzeugen (mit Kundenbindung spart es den Zuordnungsschritt)

Auf jedem Proxmox-Host als root:

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

In einem Cluster auf jedem Knoten – jeder Knoten hat eine eigene Subscription. Das Dashboard warnt von selbst, wenn ein Knoten fehlt.
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

2.9 KiB Raw Blame History Unescape Escape