From d059b59c1e1ad605ea67b11335ea6ee5ce21ac48 Mon Sep 17 00:00:00 2001
From: Yiorgis Gozadinos <ggozadinos@gmail.com>
Date: Wed, 27 May 2026 12:59:32 +0300
Subject: [PATCH] Adapt docker compose example to use the published image

---
 examples/docker/.gitignore         |  3 +++
 examples/docker/README.md          | 29 ++++++++++++++++++++++++++++-
 examples/docker/docker-compose.yml |  7 ++-----
 3 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/examples/docker/.gitignore b/examples/docker/.gitignore
index 11476b40..f72d83ac 100644
--- a/examples/docker/.gitignore
+++ b/examples/docker/.gitignore
@@ -6,3 +6,6 @@ docs/
 
 # Environment file with secrets
 .env
+
+# Local Compose override (dev builds, custom mounts, etc.)
+docker-compose.override.yml
diff --git a/examples/docker/README.md b/examples/docker/README.md
index 822b7cb5..2c4faf93 100644
--- a/examples/docker/README.md
+++ b/examples/docker/README.md
@@ -34,12 +34,39 @@ mkdir -p data docs
 # Create config file from example (required)
 cp haiku.rag.yaml.example haiku.rag.yaml
 
-# Start services
+# Start services (pulls ghcr.io/ggozad/haiku.rag-slim:latest)
 docker compose up -d
 ```
 
 Place documents in `docs/` for automatic indexing.
 
+### Building locally for development
+
+The example pulls the published image. To run a local build of
+`haiku.rag-slim` instead — typical when iterating on the codebase — drop
+a `docker-compose.override.yml` next to `docker-compose.yml` (the file
+is auto-loaded by Compose and not checked in):
+
+```yaml
+services:
+  haiku-ingester:
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.slim
+  haiku-rag:
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.slim
+```
+
+Then:
+
+```bash
+docker compose build         # builds & tags as ghcr.io/ggozad/haiku.rag-slim:latest
+docker compose up -d         # uses the local image
+docker compose pull          # back to the published image when done
+```
+
 ## Volume Mounts
 
 | Host Path | Container Path | Mounted on | Purpose |
diff --git a/examples/docker/docker-compose.yml b/examples/docker/docker-compose.yml
index f45cdd61..d5b3d6c8 100644
--- a/examples/docker/docker-compose.yml
+++ b/examples/docker/docker-compose.yml
@@ -41,10 +41,7 @@ services:
   # (creating it if missing), so its /health endpoint is a valid signal
   # that the DB exists — MCP waits on it via condition: service_healthy.
   haiku-ingester:
-    build:
-      context: ../..
-      dockerfile: docker/Dockerfile.slim
-    image: haiku-rag-slim:local
+    image: ghcr.io/ggozad/haiku.rag-slim:latest
     container_name: haiku-ingester
     command:
       [
@@ -95,7 +92,7 @@ services:
     restart: unless-stopped
 
   haiku-rag:
-    image: haiku-rag-slim:local
+    image: ghcr.io/ggozad/haiku.rag-slim:latest
     container_name: haiku-rag
     command:
       [