diff --git a/.env.example b/.env.example index 110176e..4f01021 100644 --- a/.env.example +++ b/.env.example @@ -54,6 +54,10 @@ OIDC_REDIRECT_URL=https://cloud.example.com/api/v1/auth/oidc/callback OIDC_LINK_BY_USERNAME=false # ── Office (optional) ───────────────────────────────────────────────────────── +# Office starten? Der Dienst steht im Profil "office" und bleibt sonst aus. +# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine +# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office. +# COMPOSE_PROFILES=office # Leer = aus. Container-Schnipsel: README.md OFFICE_PROVIDER= # Backend → Office diff --git a/README.md b/README.md index e33d465..b736f59 100644 --- a/README.md +++ b/README.md @@ -445,6 +445,17 @@ startet er nicht, und wer kein Office will, gibt kein Gigabyte dafür ab: docker compose --profile office up -d ``` +**Ohne Kommandozeile** – Portainer, Dockge, Komodo – gibt es kein +`--profile`, und der Container entsteht schlicht nie, ohne Fehlermeldung. +Dafür genügt eine Zeile in der `.env`, Compose liest sie für sich selbst: + +```env +COMPOSE_PROFILES=office +``` + +Gemessen: Mit dieser Zeile bringt ein einfaches `docker compose up -d` den +Office-Dienst mit, ohne sie nicht. + ### Schnipsel 1: Collabora ```yaml diff --git a/TESTING.md b/TESTING.md index 4bcef3d..7a0d3d0 100644 --- a/TESTING.md +++ b/TESTING.md @@ -685,6 +685,36 @@ Escapen: --- +## Office-Container entsteht nicht (24.08.2026) + +Kein Fehler, keine Meldung – der Container existiert einfach nicht. Ursache +ist `profiles: ["office"]`: Ein Dienst in einem Profil startet nur, wenn das +Profil ausdrücklich verlangt wird. + +Auf der Kommandozeile mit `--profile office`. **In einer Oberfläche +(Portainer, Dockge, Komodo) gibt es diesen Schalter nicht** – dort führt kein +Weg über die Bedienung, und genau da fällt man herein. + +Lösung: eine Zeile in der `.env`, die Compose für sich selbst liest. + +```env +COMPOSE_PROFILES=office +``` + +Gemessen mit den echten Dateien: + +``` +ohne COMPOSE_PROFILES: app postgres +mit COMPOSE_PROFILES: app office postgres +``` + +- [ ] Ohne die Zeile entsteht kein Office-Container 🔎 +- [ ] Mit der Zeile bringt ein einfaches `docker compose up -d` ihn mit 🔎 +- [ ] Auskommentiert lassen, solange kein Office gewollt ist – der Container + kostet rund 1 GB + +--- + ## Erreichbarkeit von außen (24.08.2026) `ERR_CONNECTION_REFUSED` beim Zugriff über die IP ist meist kein Fehler, diff --git a/deploy/.env.example b/deploy/.env.example index 5668d2c..56cc497 100644 --- a/deploy/.env.example +++ b/deploy/.env.example @@ -72,6 +72,10 @@ ADMIN_PASSWORD=changeme_strong_admin_password EXTERNAL_APPS= # ── Office (optional) ───────────────────────────────────────────────────────── +# Office starten? Der Dienst steht im Profil "office" und bleibt sonst aus. +# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine +# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office. +# COMPOSE_PROFILES=office # Leer = aus. Container-Schnipsel: README.md OFFICE_PROVIDER= # collabora | onlyoffice (auch Euro-Office) OFFICE_URL= # Backend → Office diff --git a/docker-compose.example.yml b/docker-compose.example.yml index 4ef7055..306f2ee 100644 --- a/docker-compose.example.yml +++ b/docker-compose.example.yml @@ -12,6 +12,11 @@ # OnlyOffice, Euro-Office), und jeder bringt eigene Variablen mit. Den # passenden Schnipsel zum Anhängen findest du im README. # +# Der Schnipsel steht im Profil "office" und startet deshalb NICHT bei einem +# einfachen `docker compose up -d`. Entweder `--profile office` anhängen oder +# COMPOSE_PROFILES=office in die .env schreiben – Letzteres wirkt auch in +# Oberflächen ohne Kommandozeile. +# # Hintergrund und Fallstricke: README.md # Aus dem Quelltext bauen statt ziehen: deploy/docker-compose.yml