Kubiya LogoKubiya Developer Docs
Deployment/Runners

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

  1. Decide on your environment: Kubernetes (recommended), Docker, or Virtual Machine.
  2. Go to the Runners section in the Kubiya UI and click "Add Local Runner."
  3. Follow the on-screen instructions to generate your unique install commands.
  4. Run the provided commands in your environment (do not use sample manifests from the docs).
  5. 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:

Advanced Configuration & Troubleshooting

On this page