# MCP stack - Docker Compose deployment

Runs the MCP servers (coding agent, development server, browser, MinIO) behind one Caddy gateway.
The servers' code and their images live in the `mcps` repository; this repository only deploys them
from Docker Hub (`luciolelii/*`), so the host needs no sources and no build toolchain.

```sh
cp mcp-stack.env.example .env        # then fill it in: see ENVIRONMENT.md
docker compose --env-file .env -f mcp-stack.compose.yml pull
docker compose --env-file .env -f mcp-stack.compose.yml up -d
```

On a dedicated VM add `-f mcp-stack.vm.compose.yml` to both commands.

- [MCP-STACK.md](MCP-STACK.md) - what runs, how to start and update it, security notes.
- [ENVIRONMENT.md](ENVIRONMENT.md) - every environment variable, required and optional.