From 9fd85f67e8bccfc6a3c78cb6202aeb9ece3de160 Mon Sep 17 00:00:00 2001
From: Tom <108088199+ThomasJButler@users.noreply.github.com>
Date: Mon, 15 Jun 2026 06:54:51 +0100
Subject: [PATCH] docs(readme): note Apple Silicon Docker GPU limitation

Clarify in the Docker install section that Apple Silicon Docker cannot use Metal GPU acceleration for Cookbook model serving and point users to the native Apple Silicon path.
---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index bbc831c37..79e8d9699 100644
--- a/README.md
+++ b/README.md
@@ -73,6 +73,10 @@ binds the web UI to `127.0.0.1` by default. If the port is taken, set
 `APP_PORT=7001` in `.env` and recreate the container. Set `APP_BIND=0.0.0.0`
 only when you intentionally want LAN/reverse-proxy access.
 
+> **On Apple Silicon (M-series) Macs:** Docker can't reach the Metal GPU, so
+> Cookbook serves local models on CPU only. For GPU-accelerated model serving,
+> run natively instead — see [Apple Silicon](#apple-silicon) below.
+
 ### Native Linux / macOS
 ```bash
 git clone https://github.com/pewdiepie-archdaemon/odysseus.git