Local development environment management for Polar using Docker
This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.
The dev docker command automatically detects the correct instance number. No manual -i flag is needed in most cases.
Detection priority:
CONDUCTOR_PORT env var → (port - 55000) / 10 + 1You can override with -i N if needed, but auto-detection handles Conductor workspaces automatically.
| Task | Command |
|---|---|
| Start full stack | dev docker up -d |
| Stop services | dev docker down |
| View all logs | dev docker logs |
| View service logs | dev docker logs {service} |
| Follow logs | dev docker logs -f |
| Check status | dev docker ps |
| Restart service | dev docker restart {service} |
| Shell access | dev docker shell {service} |
| Fresh start | dev docker cleanup -f && dev docker up -d |
| With monitoring | dev docker up --monitoring -d |
| Force rebuild | dev docker up -b -d |
| Service | Default Port | Description |
|---|---|---|
| api | 8000 | FastAPI backend |
| worker | - | Background job processor |
| web | 3000 | Next.js frontend |
| db | 5432 | PostgreSQL database |
| redis | 6379 | Redis cache |
| minio | 9000/9001 | S3-compatible storage |
| prometheus | 9090 | Metrics (optional) |
| grafana | 3001 | Dashboards (optional) |
Port = Base Port + (Instance × 100)
| Instance | API | Web | DB | Redis | MinIO |
|---|---|---|---|---|---|
| 0 | 8000 | 3000 | 5432 | 6379 | 9000 |
| 1 | 8100 | 3100 | 5532 | 6479 | 9100 |
| 2 | 8200 | 3200 | 5632 | 6579 | 9200 |
| Rule | Category | Description |
|---|---|---|
| service-architecture | Reference | Service details |