Docker Compose

Docker Compose is the fastest way to run the current multi-repository Monkeys stack on one machine. For a complete first-time path, start with Deploy From Zero.

Compose Layout

The Monkeys ecosystem now uses two local compose layers:

• monkeys/docker/infrastructure: PostgreSQL, Redis, Elasticsearch, Conductor, MinIO, Prometheus, Grafana.
• monkeys/docker/services: core product services and optional feature profiles.

The service compose file expects product repositories to be siblings of monkeys.

Start Shared Infrastructure

cd monkeys/docker/infrastructure
docker compose up -d

Start Core Services

cd monkeys/docker/services
docker compose up -d --build

The default profile expects these repositories beside monkeys:

• monkeys-server
• monkeys-studio
• monkeys-kernel
• monkeys-compute

Default endpoints:

Optional Profiles

Use profiles when you need extra capability services:

docker compose --profile agent up -d --build
docker compose --profile billing up -d --build
docker compose --profile data up -d --build
docker compose --profile webhook up -d --build
docker compose --profile mcp up -d --build
docker compose --profile worker up -d --build
docker compose --profile tools up -d --build

Typical Flow

1. Start infrastructure.
2. Start core services.
3. Open Studio and create or import a workflow.
4. Import external tools by manifest or OpenAPI if needed.
5. Verify the workflow through the UI or OpenAI-compatible API.

Troubleshooting

• If services cannot resolve postgres, redis, or conductor-server, confirm the infrastructure stack created the external monkeys network.
• If a service image build fails, confirm the required sibling repository exists at the expected path.
• If Studio cannot call the backend, confirm the service port mapping and frontend runtime endpoint configuration.

Stop

cd monkeys/docker/services
docker compose down
cd ../infrastructure
docker compose down