From 95fd6405be127a2909850b3d2fa2104e2107767f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?H=C3=B6rdle=20Bot?= <bot@hoerdle.local>
Date: Mon, 1 Dec 2025 15:39:54 +0100
Subject: [PATCH] docs: enhance Caddy setup documentation and update Docker
 Compose configurations

- Add instructions for handling existing Docker networks in Caddy setup
- Update docker-compose.caddy.yml to specify external network name
- Modify docker-compose.example.yml to include network configuration for the default network
---
 CADDY_SETUP.md             | 14 +++++++++++++-
 docker-compose.caddy.yml   |  4 ++--
 docker-compose.example.yml |  6 ++++++
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/CADDY_SETUP.md b/CADDY_SETUP.md
index 119668c..623e0e6 100644
--- a/CADDY_SETUP.md
+++ b/CADDY_SETUP.md
@@ -62,10 +62,22 @@ Caddy und Hördle müssen im gleichen Docker-Netzwerk kommunizieren:
 # Prüfe, ob das Netzwerk bereits existiert
 docker network ls | grep hoerdle
 
-# Falls nicht vorhanden, erstelle es
+# Falls das Netzwerk bereits existiert, aber falsche Labels hat:
+# 1. Stoppe alle Container, die das Netzwerk nutzen
+docker compose -f docker-compose.yml down
+
+# 2. Lösche das alte Netzwerk (falls keine Container mehr dranhängen)
+docker network rm hoerdle_default
+
+# 3. Erstelle das Netzwerk neu
+docker network create hoerdle_default
+
+# Falls das Netzwerk nicht existiert, erstelle es:
 docker network create hoerdle_default
 ```
 
+**Hinweis**: Die docker-compose.caddy.yml ist so konfiguriert, dass sie das Netzwerk als externes Netzwerk nutzt. Das bedeutet, dass das Netzwerk bereits existieren muss, bevor Caddy gestartet wird.
+
 ## Schritt 4: Caddy starten
 
 ### Option A: Mit docker-compose (Empfohlen)
diff --git a/docker-compose.caddy.yml b/docker-compose.caddy.yml
index 3cc52fd..7befcea 100644
--- a/docker-compose.caddy.yml
+++ b/docker-compose.caddy.yml
@@ -56,6 +56,6 @@ volumes:
 
 networks:
   default:
-    # Netzwerk wird automatisch erstellt wenn beide Compose-Dateien zusammen verwendet werden
-    # Bei separater Verwendung: docker network create hoerdle_default und external: true setzen
+    name: hoerdle_default
+    external: true
 
diff --git a/docker-compose.example.yml b/docker-compose.example.yml
index 1cd2638..870bb5c 100644
--- a/docker-compose.example.yml
+++ b/docker-compose.example.yml
@@ -37,4 +37,10 @@ services:
       timeout: 10s
       retries: 3
       start_period: 40s
+    networks:
+      - default
     # docker-entrypoint.sh handles migrations and server startup (with baseline fallback)
+
+networks:
+  default:
+    name: hoerdle_default