diff --git a/.env.example b/.env.example index 4f01021..296cf83 100644 --- a/.env.example +++ b/.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. -# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine -# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office. +# 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 OFFICE_PROVIDER= diff --git a/README.md b/README.md index b736f59..17f702f 100644 --- a/README.md +++ b/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 -startet er nicht, und wer kein Office will, gibt kein Gigabyte dafür ab: +Die Schnipsel unten starten **sofort** mit `docker compose up -d`. Das war +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 -docker compose --profile office up -d +Wer ihn dennoch wahlweise an- und ausschalten will, hängt die Zeile selbst an +den Dienst: + +```yaml + profiles: ["office"] ``` -**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. +Dann startet er nur mit `docker compose --profile office up -d` – oder mit +`COMPOSE_PROFILES=office` in der `.env`, was auch ohne Kommandozeile wirkt +(gemessen). Zum Ausschalten reicht sonst `docker compose stop office`. ### 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" diff --git a/TESTING.md b/TESTING.md index 7a0d3d0..0d3d6d8 100644 --- a/TESTING.md +++ b/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 -Profil ausdrücklich verlangt wird. +war `profiles: ["office"]` in den README-Schnipseln: Ein Dienst in einem +Profil startet nur mit `--profile office`. -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. +**In Portainer, Dockge oder Komodo gibt es diesen Schalter nicht.** Dort war +der Dienst über die Bedienung gar nicht erreichbar, und nichts wies darauf +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. - -```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 +- [ ] Schnipsel aus dem README anhängen, `docker compose up -d` → der + Office-Container entsteht 🔎 (geprüft für alle drei: `app office + postgres`) +- [ ] 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 + `.env`; Letzteres wirkt auch ohne Kommandozeile 🔎 --- diff --git a/deploy/.env.example b/deploy/.env.example index 56cc497..17a867a 100644 --- a/deploy/.env.example +++ b/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. -# Diese Zeile wirkt wie `--profile office` – und zwar auch dort, wo man keine -# Kommandozeile hat (Portainer, Dockge, Komodo). Auskommentiert = kein Office. +# 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 OFFICE_PROVIDER= # collabora | onlyoffice (auch Euro-Office) diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml index 1ba6f4e..420fb8d 100644 --- a/deploy/docker-compose.yml +++ b/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 diff --git a/docker-compose.example.yml b/docker-compose.example.yml index 306f2ee..cc2508c 100644 --- a/docker-compose.example.yml +++ b/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 -# 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. +# Der Schnipsel startet mit `docker compose up -d` sofort mit. Zum Abschalten +# `docker compose stop office`. # # Hintergrund und Fallstricke: README.md # Aus dem Quelltext bauen statt ziehen: deploy/docker-compose.yml