hallowed-book-84502
09/16/2025, 9:38 AMtall-airline-16756
09/16/2025, 9:38 AMtall-airline-16756
09/16/2025, 9:38 AMwork-laptop
• deploy-server-01
• personal-macbook
There’s no need to worry about matching your actual hostname or sticking to a strict format. Just pick something unique and meaningful to you, so you can quickly tell your devices apart when managing your LiveKit projects.
Sources: cmd/lk/utils.gohallowed-book-84502
09/16/2025, 9:39 AMtall-airline-16756
09/16/2025, 9:40 AMhallowed-book-84502
09/16/2025, 9:40 AMtall-airline-16756
09/16/2025, 9:41 AM%h for the current hostname, but that’s totally optional. Whatever works best for you!
Sources: README.mdhallowed-book-84502
09/16/2025, 9:44 AMtall-airline-16756
09/16/2025, 9:44 AM--url, --api-key, and --api-secret parameters every time you run a command—pretty handy, right?
Once you’ve set a default project, commands like lk room join or lk agent deploy will automatically use its credentials, unless you decide to specify a different one with the --project flag.
You can make a project your default either right when you add it by using the --default flag, or anytime later with the lk project set-default PROJECT_NAME command. When you list your projects with lk project list, the default one will be clearly marked with an asterisk (*), so you always know which project is set as default.
Sources: LiveKit CLI project management | LiveKit Docs | Agent deployment CLI reference | LiveKit Docshallowed-book-84502
09/16/2025, 9:46 AMtall-airline-16756
09/16/2025, 9:46 AMhallowed-book-84502
09/16/2025, 9:47 AMtall-airline-16756
09/16/2025, 9:48 AMhallowed-book-84502
09/16/2025, 9:49 AMtall-airline-16756
09/16/2025, 9:50 AMSUPABASE_URL, SUPABASE_ANON_KEY, and SUPABASE_SERVICE_KEY) in a .env.local file for your local development:
SUPABASE_URL=<https://your-project.supabase.co>
SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_KEY=your_service_key
1. Keep them private: Be sure to add .env.local to your .gitignore file. This way, your sensitive information won’t accidentally be shared in version control.
2. Deploy with secrets: You have a couple of options to securely inject your credentials during deployment:
• Using a secrets file:
lk agent create --secrets-file=.env.local
• Or via the CLI --secrets flag:
lk agent update-secrets \
--secrets "SUPABASE_URL=<https://your-project.supabase.co>" \
--secrets "SUPABASE_ANON_KEY=your_anon_key" \
--secrets "SUPABASE_SERVICE_KEY=your_service_key"
Just a quick note: each --secrets flag sets one key-value pair, and when you update secrets, the agent will perform a rolling restart to apply the changes smoothly.
Additional Tips
• If you want to replace all existing secrets at once, you can use the --overwrite flag like this:
lk agent update-secrets --secrets-file=new-secrets.env --overwrite
• And to check what secrets are currently set, run:
lk agent secrets
For your peace of mind, secret values won’t be displayed in the CLI output or dashboard to keep your information safe.
Please feel free to reach out if you have any questions or need a hand with any of these steps — I’m here to support you!
Sources: Secrets management | LiveKit Docs | Secrets management | LiveKit Docshallowed-book-84502
09/16/2025, 9:59 AMtall-airline-16756
09/16/2025, 9:59 AMrequirements.txt
◦ pyproject.toml (with sections like [tool.poetry], [tool.pdm], etc.)
◦ poetry.lock, Pipfile.lock, or uv.lock
• If it’s a Node.js project, make sure there’s a package.json file.
2. Create a Dockerfile Manually (If Needed):
If your project doesn’t have these standard files, you can create a Dockerfile in your working directory. This way, the CLI will use that file and skip trying to detect the project type.
3. Generate a Dockerfile Using the CLI:
You can also let the CLI create a Dockerfile for you by running:
lk agent dockerfile [working-dir]
This command will generate a Dockerfile and a .dockerignore tailored to your project type.
4. Double-Check Your Working Directory:
Make sure you’re running the command from the right directory where your agent code and dependencies live. If you want, you can specify the directory explicitly like this:
lk agent deploy ./path-to-agent-directory
After you’ve added the necessary files or created a Dockerfile, please try the deployment again. If you run into any more questions or need a hand, just let me know—I’m happy to assist!
Sources: pkg/agentfs/sdk_version_check.go | Agent deployment CLI reference | LiveKit Docshallowed-book-84502
09/16/2025, 10:07 AMtall-airline-16756
09/16/2025, 10:08 AMrequirements.txt file together:
1. Identify Installed Packages: If you've already installed the Python packages you need, a quick way to get a list is by running this command:
`pip freeze > requirements.txt`This will generate a requirements.txt file listing all your installed packages along with their versions.
2. Manually Add Dependencies: If you know exactly which libraries your project uses, you can simply write them down in the requirements.txt file yourself. For example:
livekit
supabase-py
python-dotenv
3. Check Your Code: Take a moment to look over your code and spot the libraries you’re importing (like import livekit or import supabase). Make sure to include those in your requirements.txt file.
Once you have your requirements.txt file ready, just place it in your project directory and try deploying again. If you hit any bumps or have questions along the way, I’m here to help!hallowed-book-84502
09/16/2025, 10:17 AMtall-airline-16756
09/16/2025, 10:19 AMDockerfile in your working directory, the CLI won’t overwrite it. So, if you want a fresh one generated, just try removing or renaming the existing file.
2. Verify Your Project Structure: It’s important that your project has the right configuration files so the CLI can detect everything properly:
3. Manually Generate the Dockerfile: If automatic generation isn’t happening, you can create the Dockerfile and .dockerignore manually by running this command:
lk agent dockerfile
And if you want to overwrite any existing files, just add the --overwrite flag—it’s that simple!
4. Check Directory Permissions: Sometimes, the CLI might not be able to create files if it doesn’t have the right permissions. Make sure it can write to your working directory.
Once you’ve gone through these steps, try deploying again. If anything feels tricky or you need a hand, just reach out—I’m here to help!
Sources: pkg/agentfs/docker_test.go | Agent deployment CLI reference | LiveKit Docshallowed-book-84502
09/16/2025, 10:22 AMtall-airline-16756
09/16/2025, 10:22 AMDockerfile in your project folder, the CLI will simply use that and skip generating a new one. If you don’t see one, no worries—just move on to the next step.
2. Generate a Dockerfile Manually: You can create a Dockerfile and a .dockerignore file by running this command:
lk agent dockerfile
3. Reinstall the LiveKit CLI: Sometimes the embedded templates might be missing if the installation wasn’t complete. Reinstalling the CLI from a trusted source like the official GitHub releases or your package manager can help make sure everything is in place.
4. Create Your Own Dockerfile: If you prefer, you can skip the CLI’s template system and write your own Dockerfile. For inspiration, you can check out the official templates here: LiveKit CLI Templates.
If you have any questions or need a hand with any of these steps, please don’t hesitate to reach out—I’m here to help!
Sources: cmd/lk/agent.go | Agent deployment CLI reference | LiveKit Docs | Builds and Dockerfiles | LiveKit Docshallowed-book-84502
09/16/2025, 10:23 AMtall-airline-16756
09/16/2025, 10:24 AMwinget install LiveKit.LiveKitCLI
• Or, if you prefer, download the precompiled binary from the latest release and follow the installation instructions there.
For macOS:
• Homebrew makes it simple to reinstall:
brew install livekit-cli
• If you run into any issues, just make sure the correct tap is added with:
brew tap livekit/livekit
brew install livekit-cli
For Linux:
• Try running this installation script:
curl -sSL <https://get.livekit.io/cli> | bash
• Alternatively, you can download the precompiled binary from the latest release.
From Source:
• If building from source is your preference, first make sure Git LFS is installed, then run:
git clone <https://github.com/livekit/livekit-cli>
make install
Once you've reinstalled, you can check everything is set up correctly by running lk --help to see the available commands. If you have any questions or need a hand with anything else, just let me know—I'm here to help!
Sources: cmd/lk/utils.go | Docs::Home | LiveKit CLI Setup | LiveKit Docs