diff --git a/docker-compose.example.yml b/docker-compose.example.yml
index cc3198a03..20467d82e 100644
--- a/docker-compose.example.yml
+++ b/docker-compose.example.yml
@@ -16,6 +16,7 @@
 services:
   postgres:
     image: pgvector/pgvector:pg18-trixie
+    # platform: linux/amd64  # uncomment on Apple Silicon if pgvector arm64 build is missing
     container_name: lobu-postgres
     environment:
       POSTGRES_USER: lobu
@@ -24,7 +25,7 @@ services:
     ports:
       - "5433:5432"
     volumes:
-      - lobu_pgdata:/var/lib/postgresql/data
+      - lobu_pgdata:/var/lib/postgresql
     restart: unless-stopped
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U lobu -d lobu"]
@@ -34,6 +35,7 @@ services:
 
   lobu:
     image: ghcr.io/lobu-ai/lobu-app:latest
+    # platform: linux/amd64  # required on Apple Silicon until multi-arch image lands (see GitHub Issues)
     container_name: lobu-app
     ports:
       - "8787:8787"
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index 03ff31a13..d83bf1d49 100644
--- a/docs/DOCKER.md
+++ b/docs/DOCKER.md
@@ -36,6 +36,10 @@ That's it. Sign up via the admin UI, add provider API keys from the settings pag
 | `OPENAI_API_KEY` / `GROQ_API_KEY` / etc. | No | Same as Anthropic — set only the providers you want available, or add them via the admin UI at runtime. |
 | `WORKER_ALLOWED_DOMAINS` | Optional | Default empty = workers have no internet. Comma-separated allowlist, or `*` for unrestricted (not recommended in prod). See `.env.example` for the full pattern. |
 
+## Apple Silicon (M1/M2/M3) note
+
+The published image is currently amd64-only. Docker on Apple Silicon refuses to pull mismatched-architecture images unless you opt into emulation. Uncomment the `platform: linux/amd64` line in `docker-compose.example.yml` to run it via Rosetta — slightly slower but functional. A multi-arch image is planned; once published, drop the override.
+
 ## Boot errors and how to read them
 
 A failing boot now prints the actual error (type, message, stack, and Zod-validation issues). If you see: