agreeable-quill-98086
09/13/2025, 8:39 AMtall-airline-16756
09/13/2025, 8:39 AMtall-airline-16756
09/13/2025, 8:39 AMLIVEKIT_URL
, LIVEKIT_API_KEY
, and LIVEKIT_API_SECRET
to avoid conflicts.
2. Install and Configure the LiveKit CLI: If you haven’t already, install the CLI and authenticate with your LiveKit Cloud project by running:
lk cloud auth
lk project set-default "<your-cloud-project>"
3. Generate Deployment Files: Use lk agent dockerfile
to create a Dockerfile and a .dockerignore
file if you need one. This helps package your agent properly.
4. Deploy Your Agent: Next, run lk agent create
to register and deploy your agent. If you have secrets to include, you can pass them using --secrets
or a --secrets-file
.
5. Manage Your Agent: Once deployed, you can easily update your agent with lk agent deploy
, roll back changes with lk agent rollback
, and keep an eye on logs using lk agent logs
.
If any part of this feels tricky or you want a hand with any step, please don’t hesitate to reach out. I’m here to help you every step of the way!
Sources: Deploy and scale agents on LiveKit Cloud | Deploying to production | LiveKit Docs | README.md | agent/.env.sample | cmd/lk/agent.goagreeable-quill-98086
09/13/2025, 9:24 AMtall-airline-16756
09/13/2025, 9:25 AMlk agent update
This will update the agent and restart it smoothly, without interrupting any active sessions.
2. Update Secrets: If you need to change secrets, you can do so with:
lk agent update --secrets KEY=VALUE
Or, if you have a file with your secrets, use:
lk agent update --secrets-file .secrets.env
3. Monitor Status: To keep an eye on things, check the agent’s status with:
lk agent status
and you can also view logs anytime using:
lk agent logs
If you’d like, I’m here to help you with any specific step or question you have!
Sources: autocomplete/fish_autocomplete | Agent deployment CLI reference | LiveKit Docs | livekit/livekit_cloud_agent.twirp.go | agent_client.go | Deploying to production | LiveKit Docsagreeable-quill-98086
09/13/2025, 9:28 AMtall-airline-16756
09/13/2025, 9:28 AMagreeable-quill-98086
09/13/2025, 10:04 AMtall-airline-16756
09/13/2025, 10:05 AMlivekit.toml
file and the project URL used by the CLI. No worries—let’s walk through some steps to help you fix this:
1. Verify `livekit.toml`: Double-check that this file has the correct subdomain for your project:
`[project]
subdomain = "your-project-subdomain"
[agent]
id = "your-agent-id"`If needed, you can regenerate this file by running:
lk agent config --id <your-agent-id>
2. Explicitly Specify the Subdomain: To avoid any confusion, try using the --subdomain
flag like this:
lk agent update --subdomain your-subdomain
3. Check Environment Variables: Make sure your LIVEKIT_URL
matches your project’s subdomain (for example, <https://your-subdomain.livekit.cloud>
). If you want to see more details, you can add --verbose
for debugging:
lk agent update --verbose
4. Validate CLI Configuration: It’s helpful to list and update your projects to ensure everything’s set up correctly:
lk project list
lk project add --name my-project --subdomain your-subdomain --api-key YOUR_KEY --api-secret YOUR_SECRET
Then, set your project as the default with:
lk project set-default my-project
5. Ensure Correct Directory: Make sure you’re running the command in the directory that contains the right livekit.toml
, or specify the path explicitly:
lk agent update /path/to/agent/directory
If you run into any other questions or need a hand with these steps, just let me know—I’m here to help!
Sources: autocomplete/fish_autocomplete | Deploying to production | LiveKit Docs | .env.example