Local Runners
Deploy and configure local runners in your own environment for enhanced control and security
Local Runners
Local runners allow you to execute Kubiya agents and tools within your own infrastructure (Kubernetes, Docker, or VM). This is ideal for organizations with strict security, compliance, or data locality requirements.
For most users, hosted runners are the fastest way to get started. Choose local runners if you need to run agents inside your own environment.
How to Deploy a Local Runner
- Decide on your environment: Kubernetes (recommended), Docker, or Virtual Machine.
- Go to the Runners section in the Kubiya UI and click "Add Local Runner."
- Follow the on-screen instructions to generate your unique install commands.
- Run the provided commands in your environment (do not use sample manifests from the docs).
- Verify the runner is connected in the Kubiya UI.
Always use the installation commands and manifests provided in the Kubiya UI for your environment. These include your unique credentials and configuration.
For detailed, environment-specific instructions, see: