Docker Compose Generator for Local Chain Stack

WHAT IT DOES

Docker Compose Generator for Local Chain Stack creates complete docker-compose.yml files for spinning up local EVM chain stacks. You define each chain with a name, Docker image, RPC port, network ID, and chain ID, and optionally add supporting services like Blockscout explorers or PostgreSQL databases. The tool generates a ready-to-use docker-compose.yml file that you can run with `docker-compose up -d` to launch your entire local blockchain development environment. Each chain runs a Foundry anvil node with configurable chain ID and port, making it easy to simulate multi-chain environments for cross-chain testing, protocol development, or smart contract debugging. The generated file includes proper container naming, port mappings, environment variables, and network configuration. This is ideal for developers testing cross-chain applications, building multi-chain protocols, or needing isolated local testnets for integration testing.

HOW TO USE

Enter a project name for container naming consistency. Define your chains—one per line—in the format: "name | image | rpc_port | network_id | chain_id". For example: "chain-a | ghcr.io/foundry-rs/foundry:latest | 8545 | 1337 | 1337". The image defaults to Foundry's anvil, but you can use any compatible EVM chain image. Add additional services—one per line—in the format: "name | image | port | depends_on". For example: "blockscout | blockscout/blockscout:latest | 4000 | chain-a,chain-b". Click "Generate docker-compose.yml." The tool builds a complete compose file with all services, networks, and dependencies. You can preview the YAML in the results panel and copy it to your clipboard. Save it as docker-compose.yml in your project directory and run `docker-compose up -d` to start the stack.

THE REAL MECHANISM

The tool uses a pure JavaScript YAML template engine that operates entirely client-side. It takes the user-provided chain and service configurations and constructs a valid docker-compose.yml file following the Docker Compose specification. For each chain, it generates a service entry with the specified image, port mapping (host:container), environment variables for RPC port, network ID, and chain ID, and a command that starts anvil with the appropriate parameters. The command uses `anvil --host 0.0.0.0 --port 8545 --chain-id` to bind to all network interfaces. For additional services, it generates service entries with port mappings and dependency declarations. All services are connected to a custom bridge network named with the project prefix. The tool validates that all required fields are present and provides sensible defaults for optional fields. The generated YAML is formatted with proper indentation and is ready to use with Docker Compose.

WHAT IT CANNOT SEE

This tool cannot start or stop Docker containers—it only generates the compose file. It cannot detect if Docker is installed or if the Docker daemon is running. It cannot validate that the generated compose file will work with the user's specific environment, operating system, or Docker version. It cannot generate configurations for non-EVM chains. It cannot deploy the stack automatically—you must run docker-compose yourself. It cannot handle port conflicts automatically or resolve system-specific issues like memory limits or file permissions. The tool does not pull Docker images or verify that the specified images exist.

PLEASE NOTE

Docker Compose Generator works for any EVM-compatible local chain stack and does not require a blockchain connection to function, though the network selector is provided for context. It is a configuration tool for developers, not an execution tool. It reads data only and does not send any information to external servers. The tool is free to use and does not require authentication. For best results, ensure Docker and Docker Compose are installed on your system before using the generated file.