docs: Doku nach fuenf Runden aufraeumen
Nach dem Hin und Her um Profile, Ports und Escaping war Sediment
liegengeblieben:
- README: "Drei Adressen fuer drei Richtungen" stand zweimal; die
Profil-Erklaerung war eine Chronik ("das war nicht immer so") statt
einer Anleitung. Jetzt ein Absatz.
- .env.example (beide): der Office-Block begann mit einem Hinweis auf
COMPOSE_PROFILES, den man nur braucht, wenn man selbst ein Profil
anlegt - als erste Zeile eines Abschnitts unbrauchbar. Raus.
- TESTING: der grosse Office-Abschnitt behauptete noch "Getestet mit
Collabora im Compose-Profil office" und pruefte "ohne --profile startet
der Container nicht". Beides ueberholt.
- Umlaute vereinheitlicht (laeuft neben gehoert), $-Hinweis von vier auf
zwei Zeilen.
Dazu zwei neue Zeilen in der Fehlertabelle des README: Container entsteht
gar nicht (Profil) und Container laeuft, aber kein Menuepunkt (leerer
OFFICE_PROVIDER oder falscher Port).
Geprueft: beide Compose-Dateien gueltig, jeder Schluessel aus dem Code
steht in deploy/.env.example, keine doppelten Absaetze mehr.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
9f5b003177
commit
7fc8bb51d5
5 files changed
+49
-67
No files matched your search
+9
-17
@@ -17,11 +17,8 @@ DB_HOST=postgres
|
||||
DB_PORT=5432
|
||||
DB_NAME=aether
|
||||
DB_USER=aether
|
||||
# Jedes Zeichen erlaubt, auch % @ : / und Leerzeichen.
|
||||
# Ein $ im Wert wird von Docker Compose als Variable gelesen und schneidet
|
||||
# lautlos ab: geheim$wort kommt als geheim an. Als $$ schreiben oder den
|
||||
# ganzen Wert in 'einfache Anfuehrungszeichen' setzen. Ein \ hilft NICHT.
|
||||
# Im Container steht danach EIN $ – so gehoert es, angemeldet wird mit einem.
|
||||
# Jedes Zeichen erlaubt – nur ein $ muss $$ heißen oder der Wert in
|
||||
# 'einfache Anführungszeichen'. Sonst schneidet Compose lautlos ab. (README)
|
||||
DB_PASSWORD=changeme_strong_password
|
||||
|
||||
# ── Sitzung ───────────────────────────────────────────────────────────────────
|
||||
@@ -44,7 +41,7 @@ APP_BIND=127.0.0.1
|
||||
|
||||
# ── Erster Start ──────────────────────────────────────────────────────────────
|
||||
# Legt den Admin an. Danach ADMIN_PASSWORD leeren.
|
||||
# Auch hier: ein $ muss $$ heissen (siehe DB_PASSWORD).
|
||||
# Auch hier: ein $ muss $$ heißen (siehe DB_PASSWORD).
|
||||
ADMIN_USERNAME=admin
|
||||
ADMIN_PASSWORD=changeme_strong_admin_password
|
||||
|
||||
@@ -72,27 +69,22 @@ ADMIN_PASSWORD=changeme_strong_admin_password
|
||||
EXTERNAL_APPS=
|
||||
|
||||
# ── Office (optional) ─────────────────────────────────────────────────────────
|
||||
# Nur noetig, wenn du dem Office-Dienst selbst ein `profiles:` gegeben hast.
|
||||
# Die Schnipsel im README haben keins und starten von allein.
|
||||
# COMPOSE_PROFILES=office
|
||||
# Leer = aus. Container-Schnipsel: README.md
|
||||
# Leer = aus, auch wenn ein Office-Container läuft. Schnipsel: README.md
|
||||
OFFICE_PROVIDER= # collabora | onlyoffice (auch Euro-Office)
|
||||
# Der Port haengt vom Anbieter ab: Collabora 9980, OnlyOffice/Euro-Office 80.
|
||||
OFFICE_URL= # Backend → Office
|
||||
# Backend → Office. Collabora lauscht auf 9980, OnlyOffice/Euro-Office auf 80.
|
||||
OFFICE_URL=
|
||||
OFFICE_PUBLIC_URL= # Browser → Office; leer = wie OFFICE_URL
|
||||
# Office → Aether; leer = PUBLIC_URL.
|
||||
# NICHT localhost, NICHT der veröffentlichte Port – beides scheitert.
|
||||
# Weder localhost noch der veröffentlichte Port – beides scheitert.
|
||||
OFFICE_WOPI_URL=
|
||||
OFFICE_ALLOWED_HOSTS= # gegen SSRF; Host aus OFFICE_URL zählt immer
|
||||
# Nur fuer OnlyOffice/Euro-Office: gemeinsames Geheimnis, mind. 32 Zeichen.
|
||||
# openssl rand -hex 32 – Collabora braucht es nicht.
|
||||
OFFICE_JWT_SECRET=
|
||||
OFFICE_JWT_SECRET= # nur OnlyOffice/Euro-Office, mind. 32 Zeichen
|
||||
OFFICE_INSECURE_TLS=false # nur für Tests mit selbstsigniertem Zertifikat
|
||||
|
||||
# Nur für den Collabora-Container aus deploy/docker-compose.yml:
|
||||
OFFICE_ALIASGROUP=http://app:8080
|
||||
OFFICE_SSL=false
|
||||
OFFICE_SSL_TERMINATION=false # produktiv true; false ohne HTTPS davor
|
||||
OFFICE_SSL_TERMINATION=false # true nur, wenn davor wirklich HTTPS endet
|
||||
OFFICE_PORT=9980
|
||||
|
||||
# ── Später ────────────────────────────────────────────────────────────────────
|
||||
|
||||
@@ -56,12 +56,11 @@ services:
|
||||
timeout: 5s
|
||||
retries: 10
|
||||
|
||||
# Office – kostet rund 1 GB Arbeitsspeicher, deshalb hier im Profil:
|
||||
# docker compose -f deploy/docker-compose.yml --profile office up -d
|
||||
# Achtung: Oberflächen wie Portainer oder Dockge kennen `--profile` nicht.
|
||||
# Dort entsteht der Container nie, ohne Fehlermeldung – für solche Fälle
|
||||
# entweder COMPOSE_PROFILES=office in die .env oder die Zeile `profiles:`
|
||||
# streichen. Die Schnipsel im README haben deshalb keine.
|
||||
# Office – kostet rund 1 GB, deshalb hier im Profil (Entwicklerdatei, immer
|
||||
# von der Kommandozeile): ... --profile office up -d
|
||||
# Die Schnipsel im README haben bewusst kein Profil: Oberflächen wie
|
||||
# Portainer oder Dockge kennen `--profile` nicht, dort entstünde der
|
||||
# Container nie – ohne Fehlermeldung.
|
||||
collabora:
|
||||
container_name: aether-collabora
|
||||
image: collabora/code:latest
|
||||
|
||||
Reference in new issue
Block a user