fix(office): Schnipsel ohne Profil – sie starten jetzt beim Einfuegen

profiles: [office] war als Sparmassnahme gedacht: Der Container laeuft nur
auf Wunsch. In Portainer/Dockge/Komodo gibt es aber kein --profile, und der
Dienst entstand dort nie – ohne Fehlermeldung, ohne Hinweis, ohne Weg ueber
die Bedienung.

Eine Voreinstellung, bei der das Einfuegen des Schnipsels nichts bewirkt,
ist die falsche. Alle drei Schnipsel starten jetzt mit  (geprueft: app office postgres). Abschalten: docker compose stop
office. Wer ein Profil will, haengt die Zeile selbst an.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.env.example

@@ -54,9 +54,8 @@ 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.
+# Nur noetig, wenn du dem Office-Dienst selbst ein `profiles:` gegeben hast.
-# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine
+# Die Schnipsel im README haben keins und starten von allein.
-# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office.
 # COMPOSE_PROFILES=office
 # Leer = aus. Container-Schnipsel: README.md
 OFFICE_PROVIDER=

README.md

@@ -438,23 +438,24 @@ Aether unter `app:8080` – „localhost" ist aus seinem Container heraus er sel
 **Drei Adressen für drei Richtungen.** Das wirkt übertrieben, bis man es einmal
 aufgebaut hat – die häufigste Fehlerquelle beim Aufbau.
 
-Alle Schnipsel unten legen den Dienst ins Profil `office`. Ohne das Profil
+Die Schnipsel unten starten **sofort** mit `docker compose up -d`. Das war
-startet er nicht, und wer kein Office will, gibt kein Gigabyte dafür ab:
+nicht immer so: Anfangs stand in jedem `profiles: ["office"]`, damit der
+Container nur auf Wunsch läuft. Ein Dienst in einem Profil startet aber nur
+mit `--profile office` – und in einer Oberfläche wie Portainer, Dockge oder
+Komodo gibt es diesen Schalter nicht. Der Container entstand dort nie, ohne
+eine einzige Fehlermeldung. Eine Voreinstellung, bei der das Einfügen des
+Schnipsels nichts bewirkt, ist die falsche.
 
-```bash
+Wer ihn dennoch wahlweise an- und ausschalten will, hängt die Zeile selbst an
-docker compose --profile office up -d
+den Dienst:
+
+```yaml
+    profiles: ["office"]
 ```
 
-**Ohne Kommandozeile** – Portainer, Dockge, Komodo – gibt es kein
+Dann startet er nur mit `docker compose --profile office up -d` – oder mit
-`--profile`, und der Container entsteht schlicht nie, ohne Fehlermeldung.
+`COMPOSE_PROFILES=office` in der `.env`, was auch ohne Kommandozeile wirkt
-Dafür genügt eine Zeile in der `.env`, Compose liest sie für sich selbst:
+(gemessen). Zum Ausschalten reicht sonst `docker compose stop office`.
-
-```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
 
@@ -462,7 +463,6 @@ Office-Dienst mit, ohne sie nicht.
   office:
     container_name: aether-office
     image: collabora/code:latest
-    profiles: ["office"]
     restart: unless-stopped
     environment:
       # Wer seine Dateien hier öffnen darf. Punkte maskieren – Collabora liest
@@ -498,7 +498,6 @@ OFFICE_ALLOWED_HOSTS=office
   office:
     container_name: aether-office
     image: onlyoffice/documentserver:latest
-    profiles: ["office"]
     restart: unless-stopped
     environment:
       WOPI_ENABLED: "true"      # ohne das gibt es kein /hosting/discovery
@@ -529,7 +528,6 @@ heißen gleich. Für uns ist es deshalb **derselbe Anbieter** –
   office:
     container_name: aether-office
     image: ghcr.io/euro-office/documentserver:latest
-    profiles: ["office"]
     restart: unless-stopped
     environment:
       WOPI_ENABLED: "true"

TESTING.md

@@ -688,30 +688,21 @@ 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
+war `profiles: ["office"]` in den README-Schnipseln: Ein Dienst in einem
-Profil ausdrücklich verlangt wird.
+Profil startet nur mit `--profile office`.
 
-Auf der Kommandozeile mit `--profile office`. **In einer Oberfläche
+**In Portainer, Dockge oder Komodo gibt es diesen Schalter nicht.** Dort war
-(Portainer, Dockge, Komodo) gibt es diesen Schalter nicht** – dort führt kein
+der Dienst über die Bedienung gar nicht erreichbar, und nichts wies darauf
-Weg über die Bedienung, und genau da fällt man herein.
+hin. Eine Voreinstellung, bei der das Einfügen des Schnipsels nichts bewirkt,
+ist die falsche – die Schnipsel haben deshalb **kein** Profil mehr.
 
-Lösung: eine Zeile in der `.env`, die Compose für sich selbst liest.
+- [ ] Schnipsel aus dem README anhängen, `docker compose up -d` → der
-
+      Office-Container entsteht 🔎 (geprüft für alle drei: `app office
-```env
+      postgres`)
-COMPOSE_PROFILES=office
+- [ ] Abschalten mit `docker compose stop office`
-```
+- [ ] Wer ein Profil will, hängt `profiles: ["office"]` selbst an – dann
-
+      entweder `--profile office` oder `COMPOSE_PROFILES=office` in der
-Gemessen mit den echten Dateien:
+      `.env`; Letzteres wirkt auch ohne Kommandozeile 🔎
-
-```
-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
 
 ---
 

deploy/.env.example

@@ -72,9 +72,8 @@ ADMIN_PASSWORD=changeme_strong_admin_password
 EXTERNAL_APPS=
 
 # ── Office (optional) ─────────────────────────────────────────────────────────
-# Office starten? Der Dienst steht im Profil "office" und bleibt sonst aus.
+# Nur noetig, wenn du dem Office-Dienst selbst ein `profiles:` gegeben hast.
-# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine
+# Die Schnipsel im README haben keins und starten von allein.
-# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office.
 # COMPOSE_PROFILES=office
 # Leer = aus. Container-Schnipsel: README.md
 OFFICE_PROVIDER=                # collabora | onlyoffice (auch Euro-Office)

deploy/docker-compose.yml

@@ -56,7 +56,12 @@ services:
       timeout: 5s
       retries: 10
 
-  # Office – nur mit `--profile office`, kostet rund 1 GB Arbeitsspeicher.
+  # 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.
   collabora:
     container_name: aether-collabora
     image: collabora/code:latest

docker-compose.example.yml

@@ -12,10 +12,8 @@
 # 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
+# Der Schnipsel startet mit `docker compose up -d` sofort mit. Zum Abschalten
-# einfachen `docker compose up -d`. Entweder `--profile office` anhängen oder
+# `docker compose stop office`.
-# 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