Docker Compose Deployment

The root docker-compose.yml in feros is explicitly tuned for local development. It now defaults to prebuilt GHCR images for faster startup, with an optional source-build override.

Services

• db
• studio-api
• voice-server
• studio-web

Recommended Startup

cp .env.example .env

# Default: run prebuilt images
docker compose up -d

# Optional: build Rust/Python core from source
# (use when changing voice/server, voice/engine, or studio/api PyO3 bindings)
docker compose -f docker-compose.yml -f docker-compose.source.yml up -d --build

Compose Files and Roles

• docker-compose.yml: local development stack using prebuilt ghcr.io/ferosai/* images.
• docker-compose.source.yml: override file that adds build: blocks on top of the base stack.
• The source override is merged with the base file; ports, env vars, volumes, and dependencies still come from docker-compose.yml.

Important Environment Notes

• Set AUTH__SECRET_KEY and keep it consistent across services.
• Set a proper telephony voice_server_url in app settings for public webhook usage.
• For production, do not reuse the local-development compose file as-is.