docs: add podman deployment guide

New docs/DEPLOY.md covering container image, compose config, volume
mounts, host networking, operations, and troubleshooting. Updated
README, INSTALL, CHEATSHEET, and DEBUG to reference it.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/DEBUG.md

@@ -123,3 +123,41 @@ bouncer -c config/bouncer.toml -v 2>&1 | grep -v aiosqlite
 ```
 
 The `grep -v aiosqlite` filters out noisy SQLite debug lines.
+
+## Container Debugging
+
+### Logs
+
+```bash
+podman logs -f bouncer                          # follow
+podman logs --tail 50 bouncer                   # last 50 lines
+podman logs bouncer 2>&1 | grep -E 'INFO|WARN'  # important only
+podman logs bouncer 2>&1 | grep -v aiosqlite    # filter sqlite noise
+```
+
+### No log output from container
+
+Two things must be set:
+
+1. `PYTHONUNBUFFERED=1` in the Containerfile
+2. `logging: driver: k8s-file` in compose.yaml
+
+Verify log driver:
+
+```bash
+podman inspect bouncer --format '{{.HostConfig.LogConfig.Type}}'
+```
+
+### Container exits immediately
+
+```bash
+podman logs bouncer
+```
+
+Likely causes: missing config file, SOCKS5 proxy not running, TOML syntax error.
+
+### Shell into running container
+
+```bash
+podman exec -it bouncer bash
+```