← ClaudeAtlas

local-docker-port-resolverlisted

Add or repair automatic host-port selection for enabled services in local Docker Compose stacks and standardize the project-native full-stack launcher. Use when development or local simulation launchers must avoid conflicts across applications, proxies, mail UIs, dashboards, and other published services while synchronizing public URLs. Keep actual production endpoints explicit.
1ntekhab/local-docker-port-resolver · ★ 0 · AI & Automation · score 75
Install: claude install-skill 1ntekhab/local-docker-port-resolver
# Local Docker Port Resolver Add predictable local Docker Compose port fallback without changing internal service ports or actual production addressing. ## Inspect before changing anything - Find every supported local mode and start command, package-manager script, Compose file and overlay, profile, environment example, and run document. - Render or inspect each selected mode to identify every enabled host-published port. Record a target name, Compose service and fixed container port, host-port environment variable, preferred default, bind address, displayed URL, and whether the service is optional. - Inspect profiles and overlays before deciding that a target is active. Never enable Grafana, Mailpit, a debugger, or another optional service merely so its port can be resolved. - Search for every consumer of the primary or auxiliary public URLs: backend base URLs, CSRF/CORS/WebSocket origins, OAuth callbacks, frontend API configuration, E2E defaults, health checks, MFA/WebAuthn relying-party origins, proxy redirects, mail links, dashboards, and generated links. - Preserve unrelated working-tree changes. Do not read or print unrelated secrets from local environment files or rendered Compose output. ## Choose the launcher integration - Prefer the language/runtime already required by the repository and wire the launcher into its existing local start command. - In every pnpm-managed repository, expose and document `pnpm dev:up` as the canonical command for starting the complet