diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..2f11300
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,20 @@
+# companion-api
+API_PORT=3850
+NODE_ENV=development
+
+# PostgreSQL (must match @deployments/docker-compose.yml)
+DATABASE_HOST=localhost
+DATABASE_PORT=26407
+DATABASE_USER=lilith
+DATABASE_PASSWORD=lilith
+DATABASE_NAME=companion
+DATABASE_SYNCHRONIZE=false
+
+# Redis
+REDIS_HOST=localhost
+REDIS_PORT=26406
+
+# Upstream services (resolved via @lilith/service-registry in production)
+AI_CORE_URL=http://localhost:3790
+MODEL_BOSS_URL=http://localhost:8210
+SPEECH_SYNTHESIS_URL=http://localhost:41222