docs(office): OIDC ins schlanke Beispiel, Office-Server als Schnipsel

Das Wurzel-Beispiel enthielt keinen einzigen OIDC-Schlüssel – wer sich
über PocketID anmelden will, fand nirgends, wohin damit. Jetzt drin,
samt der Warnung zu OIDC_LINK_BY_USERNAME: vor der ersten Anmeldung
setzen, danach existiert das zweite Konto schon.

Der Office-Container ist aus dem Beispiel raus. Es gibt drei zur Auswahl,
jeder bringt eigene Variablen mit, und man will genau einen – sie stehen
jetzt als anhängbare Schnipsel im README (Collabora, OnlyOffice,
Euro-Office). Alle drei gegen das Beispiel geprüft: docker compose config
läuft durch.

Euro-Office (seit 09.06.2026, in Nextcloud Hub 26) ist ein
OnlyOffice-Fork und läuft über denselben Adapter – OFFICE_PROVIDER
bleibt onlyoffice, nur ein anderes Abbild.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
HoneyandClaude Opus 5 committed 2026-08-24 10:08:16 +02:00
1 parent 13681958dd
commit 16ab6f385b
3 files changed
+145 -44

No files matched your search

+23 -9
View File
@@ -44,8 +44,27 @@ APP_PORT=8080
ADMIN_USERNAME=admin
ADMIN_PASSWORD=
# ── Anmeldung über einen Identitätsanbieter (optional) ───────────────────────
# Leerer OIDC_ISSUER = aus, dann nur Benutzername + Passwort.
# Die Rücksprung-Adresse muss exakt <PUBLIC_URL>/api/v1/auth/oidc/callback sein
# und beim Anbieter als erlaubte Redirect-URI eingetragen werden.
OIDC_ISSUER=
OIDC_CLIENT_ID=aether
OIDC_CLIENT_SECRET=
OIDC_REDIRECT_URL=https://cloud.example.com/api/v1/auth/oidc/callback
# Bestehendes Konto mit derselben Kennung verbinden, statt ein zweites
# anzulegen. **Vor der ersten Anmeldung setzen** – danach existiert das zweite
# Konto ("marc2", leer, ohne Adminrecht) schon, und das Verbinden kommt zu spät.
#
# Nur bei einem eigenen Anbieter (PocketID, Authentik), dessen Konten du selbst
# anlegst. Bei freier Registrierung wäre es die Übernahme fremder Konten.
OIDC_LINK_BY_USERNAME=false
# ── Office (optional) ─────────────────────────────────────────────────────────
# Leer lassen = aus. Sonst `docker compose --profile office up -d`.
# Leer lassen = aus. Den passenden Container-Schnipsel (Collabora, OnlyOffice
# oder Euro-Office) findest du im README – er bringt seine eigenen Variablen
# mit. Hier steht nur, was Aether selbst wissen muss.
#
# Drei Adressen für drei Richtungen, und sie sind selten gleich:
# OFFICE_URL Backend → Office-Server
@@ -53,14 +72,9 @@ ADMIN_PASSWORD=
# OFFICE_WOPI_URL Office-Server → Aether (NICHT localhost – aus seinem
# Container heraus ist das er selbst)
OFFICE_PROVIDER=
OFFICE_URL=http://collabora:9980
OFFICE_URL=http://office:9980
OFFICE_PUBLIC_URL=https://office.example.com
OFFICE_WOPI_URL=http://app:8080
# Ziele, die das Backend anfragen darf – gegen SSRF.
OFFICE_ALLOWED_HOSTS=collabora
OFFICE_ALIASGROUP=http://app:8080
# Hinter deinem Reverse Proxy mit HTTPS: beide auf true.
OFFICE_SSL=false
OFFICE_SSL_TERMINATION=true
OFFICE_PORT=9980
# Ziele, die das Backend anfragen darf – gegen SSRF. Nur der Office-Server.
OFFICE_ALLOWED_HOSTS=office