Deploy Agents

Deploy, update, and roll back LiveKit agents on Telnyx.

First deploy

lk agent deploy handles everything — if the agent doesn’t exist yet, it creates it automatically.

lk agent deploy . --secrets TELNYX_API_KEY=<your-key>

Your code is uploaded, a container image is built on Telnyx’s build service, and the agent is deployed to your region.

Updating

Run the same command to deploy a new version:

lk agent deploy .

The platform performs a rolling update — new containers are started, health-checked, and old containers are drained gracefully.

Rollback

Roll back to the previous version:

lk agent rollback <agent-id>

Custom Dockerfiles

You can include a custom Dockerfile in your project for additional dependencies or configuration. Standard Docker build constraints apply.

Autoscaling

The platform automatically scales your agent based on demand. Scaling parameters are managed by the platform — load_fnc and load_threshold are not user-configurable.