diff --git a/docker-compose.yml b/docker-compose.yml
index b2b66ab..400b38e 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -39,6 +39,8 @@ services:
 
   # Paper Dynasty API (optional - can run locally with 'uvicorn app.main:app --reload')
   # Uncomment this section if you want to run the API in Docker
+  # IMPORTANT: db_engine.py calls db.create_tables() at import time which causes
+  # race conditions with multiple gunicorn workers. Run API locally for now.
   # api:
   #   build: .
   #   restart: unless-stopped