diff --git a/CLAUDE.md b/CLAUDE.md
index 56735b4..d4f1c3e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -24,6 +24,26 @@ pip install -r requirements.txt     # Install dependencies
 - Multiple cardsets (seasons) with different priorities for gameplay
 - Use factory data in testing as often as possible
 
+## Deployment
+
+### Production Environment
+- **Host**: `ssh sba-bots` (10.10.0.88, alias `pd-bots`)
+- **Path**: `/home/cal/container-data/paper-dynasty`
+- **Bot container**: `paper-dynasty_discord-app_1`
+- **Logs**: `ssh sba-bots "docker logs --since 1h paper-dynasty_discord-app_1"`
+- **Other services on same host**: `paper-dynasty_adminer_1`, `paper-dynasty_db_1`, `sba-website_sba-web_1`, `sba-ghost_sba-ghost_1`
+- **Image**: `manticorum67/paper-dynasty-discordapp` (Docker Hub)
+- **Version file**: `VERSION` (current: 1.9.2) — bump before merge to `main`
+- **Health**: Port 8080 — `/health`, `/ready`, `/metrics`, `/diagnostics`
+- **Env vars**: `BOT_TOKEN`, `GUILD_ID`, `API_TOKEN`, `DATABASE` (Dev/Prod), `LOG_LEVEL`, `TZ=America/Chicago`
+
+### CI/CD
+Builds and deploys are handled by Gitea Actions. Create a PR to `main` using `tea`:
+```bash
+tea pulls create --repo cal/paper-dynasty --head <branch> --base main --title "title" --description "description"
+```
+Gitea validates the version, builds the Docker image, and deploys on merge.
+
 ## Development Notes
 
 - Connect to proper docker socket when running tests