Skip to main content

​
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 — LiveKit agent worker

  • No published ports (connects outbound to LiveKit)
  • Loads .env.local from the host
  • Runs: pnpm agent:start

​
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