docker-compose-dev

Orchestrate Proto Fleet development with Docker Compose base and override files.

49|15|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/block/proto-fleet --skill docker-compose-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-compose-dev
Source: https://github.com/block/proto-fleet/tree/main/.claude/skills/docker-compose-dev
Command: npx skills add https://github.com/block/proto-fleet --skill docker-compose-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates and simplifies local development of Proto Fleet by using Docker Compose with a clear split between base definitions and development overrides.

Core Features & Use Cases

  • Base vs. dev overrides: Keeps common service definitions in docker-compose.base.yaml while developing changes in docker-compose.yaml.
  • Host networking prerequisites: Requires host networking on macOS/Windows; Linux handles it implicitly to allow plugin and miner communications.
  • Troubleshooting guidance: Provides steps to verify service scope, port bindings, and networking when services fail to start.

Quick Start

Start the development stack with Docker Compose, ensuring the base and dev override files are aligned and host networking is enabled where required.

Frequently Asked Questions about docker-compose-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split Docker Compose configuration into base and dev override files?

Splitting Docker Compose configuration involves keeping common service definitions in docker-compose.base.yaml while applying development changes in docker-compose.yaml. This approach maintains a clear separation between stable configurations and local development overrides.

Why does Docker Compose fail to start services due to port binding conflicts?

Docker Compose port binding failures occur when required port mappings are misconfigured or overlap. Troubleshooting requires verifying service scope, validating port bindings in the compose files, and checking Docker host networking prerequisites before startup.

Do I need to enable Docker host networking for local development on macOS and Windows?

Docker host networking is required for local development on macOS and Windows to allow plugin and miner communications. Linux handles host networking implicitly, so no manual configuration is needed for Linux environments.

What is the best way to troubleshoot Docker Compose startup issues in a local dev environment?

Troubleshooting Docker Compose startup issues requires verifying service scope, checking port bindings, and validating host networking. Ensure base and dev override files are aligned and network prerequisites are met before attempting to start the stack.

Can I use Docker Compose to orchestrate a local development stack across different operating systems?

Docker Compose orchestrates local development stacks across macOS, Windows, and Linux environments. You must ensure host networking is explicitly enabled on macOS and Windows, while Linux handles it implicitly for seamless plugin communication.