florian.wilde/ProxLedger
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity

#029 Einrichtungsdokumentation #29

New Issue
Closed
opened 2026-09-18 22:51:29 +00:00 by florian.wilde · 0 comments
florian.wilde commented 2026-09-18 22:51:29 +00:00
Owner
Copy Link
Copy Source

Ziel

Anleitungen für alles, was rund um ProxLedger eingerichtet wird: HTTPS, OIDC mit authentik, Sicherung –
und die richtige Reihenfolge, in der das geschehen muss.

Aufgaben

  • docs/betrieb/inbetriebnahme.md – von null zum meldenden Host
  • docs/betrieb/reverse-proxy.md – nginx Proxy Manager und netbird
  • docs/betrieb/authentik.md – OIDC Schritt für Schritt, mit Fehlerbildern
  • docs/betrieb/sicherung.md – sichern und zurückspielen
  • Verweise aus README und Handbuch

Beim Schreiben gefunden

Zwei Stellen taugten für einen Betrieb hinter einem Reverse Proxy nicht:

  1. Die OIDC-Rückkehradresse kam allein aus APP_URL und übersah die Dashboard-Adresse aus den
    Einstellungen. Wer nur letztere gesetzt hatte, bekam vom Anbieter einen Redirect URI Error.
  2. Beim Einlösen des Codes wurde die Adresse der eingehenden Anfrage verwendet – hinter einem
    Proxy also die interne. Der Anbieter hat aber die öffentliche hinterlegt; der Tausch wäre
    gescheitert. Jetzt wird dieselbe öffentliche Adresse gebildet wie für die Weiterleitungen.

Entscheidung

Die Reihenfolge steht bewusst am Anfang der Inbetriebnahme: Adresse festlegen, dann Passkeys und
Agents. Ein Passkey gilt nur für die Domäne, unter der er entstanden ist, und die Adresse steckt im
Installations-Einzeiler. Wer das übergeht, macht beides zweimal.

Quelle: docs/issues/029-betriebsdokumentation.md – dort wird dieses Issue gepflegt.

## Ziel Anleitungen für alles, was rund um ProxLedger eingerichtet wird: HTTPS, OIDC mit authentik, Sicherung – und die richtige Reihenfolge, in der das geschehen muss. ## Aufgaben - [x] `docs/betrieb/inbetriebnahme.md` – von null zum meldenden Host - [x] `docs/betrieb/reverse-proxy.md` – nginx Proxy Manager und netbird - [x] `docs/betrieb/authentik.md` – OIDC Schritt für Schritt, mit Fehlerbildern - [x] `docs/betrieb/sicherung.md` – sichern und **zurückspielen** - [x] Verweise aus README und Handbuch ## Beim Schreiben gefunden Zwei Stellen taugten für einen Betrieb hinter einem Reverse Proxy nicht: 1. Die **OIDC-Rückkehradresse** kam allein aus `APP_URL` und übersah die Dashboard-Adresse aus den Einstellungen. Wer nur letztere gesetzt hatte, bekam vom Anbieter einen *Redirect URI Error*. 2. Beim **Einlösen des Codes** wurde die Adresse der eingehenden Anfrage verwendet – hinter einem Proxy also die interne. Der Anbieter hat aber die öffentliche hinterlegt; der Tausch wäre gescheitert. Jetzt wird dieselbe öffentliche Adresse gebildet wie für die Weiterleitungen. ## Entscheidung Die Reihenfolge steht bewusst am Anfang der Inbetriebnahme: **Adresse festlegen, dann Passkeys und Agents.** Ein Passkey gilt nur für die Domäne, unter der er entstanden ist, und die Adresse steckt im Installations-Einzeiler. Wer das übergeht, macht beides zweimal. --- Quelle: `docs/issues/029-betriebsdokumentation.md` – dort wird dieses Issue gepflegt.
florian.wilde added this to the v0.19.0 milestone 2026-09-18 22:51:29 +00:00
florian.wilde added the doku label 2026-09-18 22:51:29 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
agent
alerts
api
backend
buchhaltung
bug
chore
datenbank
deployment
docs
doku
export
feldtest
infrastruktur
prototyp
security
sicherheit
test
ui
No labels doku
Milestone
No items
No Milestone v0.19.0
Projects
Clear projects
No projects
Assignees
Clear assignees
florian.wilde (Florian Wilde)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/ProxLedger#29