diff --git a/quickstart.md b/quickstart.md
index 86d4851b..100a4fe2 100644
--- a/quickstart.md
+++ b/quickstart.md
@@ -48,6 +48,10 @@ Think of it like having Siri/Alexa, but it's **your own AI** running on **your h
 - **Linux**: [Install Docker](https://docs.docker.com/engine/install/)
 - **After install**: Make sure Docker Desktop is running
 
+> **WSL Users**: Chronicle services will fail to start unless Docker
+> is installed and running inside WSL2
+> (or Docker Desktop with **WSL integration enabled**).
+
 **uv** (Python package manager):
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -319,4 +323,4 @@ Before connecting your phone, make sure everything works:
 
 - **Full Documentation**: [CLAUDE.md](CLAUDE.md) - Complete technical reference
 - **Architecture Details**: [Docs/features.md](Docs/features.md) - How everything works  
-- **Advanced Setup**: [Docs/init-system.md](Docs/init-system.md) - Power user options
\ No newline at end of file
+- **Advanced Setup**: [Docs/init-system.md](Docs/init-system.md) - Power user options