From 256bafe30df6a7fd76b7661f46f8110366b0a919 Mon Sep 17 00:00:00 2001 From: Oliver Hofmann Date: Thu, 7 May 2026 16:14:44 +0200 Subject: [PATCH] Explain network_mode: host motivation in README --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5c39257..c2ad8e1 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,13 @@ Admin-Oberfläche: `http://localhost:5173` docker compose up -d ``` -Zieht das Image von DockerHub, lädt Variablen aus `.env` und verwendet `network_mode: host` — der Container erreicht Ollama direkt über `localhost:11434`. +Zieht das Image von DockerHub und lädt Variablen aus `.env`. + +Das Setup verwendet `network_mode: host`: Der Container teilt den Netzwerkstack des Hosts, statt ein eigenes virtuelles Netzwerk zu bekommen. Das ist hier aus zwei Gründen die richtige Wahl: + +1. **Ollama soll nicht von außen erreichbar sein.** Ollama läuft auf dem Host und ist an `127.0.0.1:11434` gebunden — nur lokal erreichbar. Mit einem eigenen Container-Netzwerk (Bridge-Mode) wäre `localhost` aus Sicht des Containers der Container selbst, nicht der Host. Die übliche Alternative (`host.docker.internal` + `extra_hosts`) ist auf Linux unzuverlässig. + +2. **Kein doppeltes Port-Mapping nötig.** Mit `network_mode: host` sind Port 8000 und 8001 direkt auf dem Host verfügbar, ohne `ports:`-Einträge in der Compose-Datei. ### Image selbst bauen und pushen