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:
Log forwarding to third-party services (Datadog, Sentry, CloudWatch) is coming soon.