All skills
Skillintermediate

Local Environment Skill

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.

Claude Code Knowledge Pack7/10/2026

Overview

Local Environment Skill

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.

Instance Auto-Detection

The dev docker command automatically detects the correct instance number. No manual -i flag is needed in most cases.

Detection priority:

  1. CONDUCTOR_PORT env var → (port - 55000) / 10 + 1
  2. Workspace path hash → stable instance derived from the repo root path

You can override with -i N if needed, but auto-detection handles Conductor workspaces automatically.

When to Use

  • User asks to start/stop the local environment
  • User needs to view logs or debug issues
  • User wants to run multiple isolated instances
  • User needs to understand the service architecture
  • User encounters container or service errors

Quick Reference

TaskCommand
Start full stackdev docker up -d
Stop servicesdev docker down
View all logsdev docker logs
View service logsdev docker logs {service}
Follow logsdev docker logs -f
Check statusdev docker ps
Restart servicedev docker restart {service}
Shell accessdev docker shell {service}
Fresh startdev docker cleanup -f && dev docker up -d
With monitoringdev docker up --monitoring -d
Force rebuilddev docker up -b -d

Services

ServiceDefault PortDescription
api8000FastAPI backend
worker-Background job processor
web3000Next.js frontend
db5432PostgreSQL database
redis6379Redis cache
minio9000/9001S3-compatible storage
prometheus9090Metrics (optional)
grafana3001Dashboards (optional)

Instance Port Mapping

Port = Base Port + (Instance × 100)

InstanceAPIWebDBRedisMinIO
080003000543263799000
181003100553264799100
282003200563265799200

Rules Index

RuleCategoryDescription
service-architectureReferenceService details