Skip to main content

Regions

Deploy to the region closest to your users. See Regions for all available endpoints.

Environment variables and livekit.toml

Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET as environment variables. You also need a livekit.toml in your project directory that defines the subdomain and agent ID:
[project]
subdomain = "nyc1"

[agent]
id = "<agent-id>"
lk agent create writes the agent ID to livekit.toml. Don’t edit the [agent] section manually. If you clone an example repo, remove the [agent] section before running lk agent create so a fresh ID is generated.
For multi-agent projects, use the --config flag to point at different TOML files:
lk agent deploy . --config agent-a.toml
lk agent deploy . --config agent-b.toml

Multiple environments

Use separate API keys for dev, staging, and production environments. Each key operates independently.

Log access

Stream logs from your running agent:
lk agent logs <agent-id>
Log forwarding to third-party services (Datadog, Sentry, CloudWatch) is coming soon.