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:

# 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. If docker info shows Cannot connect to the Docker daemon, open Docker Desktop (macOS/Windows) or run sudo systemctl start docker (Linux).

Quick start

# 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:

docker compose restart agent

Logs

# View logs for both services
docker compose logs -f

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

Getting Started

Building Flows

AI-Powered Generation

Testing Your Agent

Tools

Post-Processing

Deployment

Docker Compose

Docker Compose

Prerequisites

Quick start

Services

`app` — Next.js web application

`agent` — Python agent server

Environment variables

Logs

​Docker Compose

​Prerequisites

​Quick start

​Services

​app — Next.js web application

​agent — Python agent server

​Environment variables

​Logs

Docker Compose

Prerequisites

Quick start

Services

`app` — Next.js web application

`agent` — Python agent server

Environment variables

Logs