> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceblox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker Compose

> Deploy the full Voiceblox stack (app + agent) using Docker Compose.

# Docker Compose

Voiceblox ships with a `docker-compose.yml` that starts both the web app and the agent worker.

## Prerequisites

Make sure Docker is installed and running:

```bash theme={null}
# Check if Docker is installed
docker --version

# Check if Docker is running
docker info
```

If `docker --version` returns `command not found`, install Docker from [docker.com/get-started](https://www.docker.com/get-started/). If `docker info` shows `Cannot connect to the Docker daemon`, open **Docker Desktop** (macOS/Windows) or run `sudo systemctl start docker` (Linux).

## Quick start

```bash theme={null}
# Build and start both services
docker compose up --build

# Stop both services
docker compose down
```

## Services

### `app` — Next.js web application

* Port: `3000`
* Loads `.env.local` from the host
* Runs: `pnpm start`

### `agent` — Python agent server

* No published ports (connects outbound to LiveKit)
* Loads `.env.agent` from the host
* Runs: `pnpm agent:server`

## Environment variables

API keys are configured inside the app (Settings dialog). The agent worker reads keys at startup, so after adding keys for a new provider restart the agent service:

```bash theme={null}
docker compose restart agent
```

## Logs

```bash theme={null}
# View logs for both services
docker compose logs -f

# View logs for just the agent
docker compose logs -f agent
```