Kubiya Runners

Runners are lightweight services that execute Kubiya agents in various environments. They provide a secure and efficient way to run agent workloads, handling the execution environment, dependencies, and security isolation.

Types of Runners

Kubiya provides two types of runners to meet different deployment needs:

Hosted Runners

Hosted runners are fully managed by Kubiya and require no infrastructure setup on your part. They offer:

• Zero maintenance overhead
• Automatic scaling based on workload
• Redundancy across multiple availability zones
• Continuous updates with latest features
• Built-in monitoring and alerting

Learn more about hosted runners →

Local Runners

Local runners allow you to deploy and manage the agent execution infrastructure in your own environment. Benefits include:

• Full control over the execution environment
• Enhanced security for sensitive workloads
• Data locality and compliance with regulatory requirements
• Custom resource allocation
• Integration with existing infrastructure

Learn more about local runners →

Deployment Options

Architecture

Runners use a secure, lightweight architecture that consists of several components:

1. Runner Service: The core component that communicates with the Kubiya platform
2. Execution Environment: Isolated sandbox for running agent code
3. Dependency Manager: Handles required libraries and tools for agents
4. Security Layer: Enforces access controls and resource limits

graph TD
    A[Kubiya Platform] <-->|API| B[Runner Service]
    B <--> C[Execution Environment]
    B <--> D[Dependency Manager]
    B <--> E[Security Layer]
    C <--> F[Agent Code]
    E <--> G[Access Controls]
    E <--> H[Resource Limits]

Key Features

• Secure execution: Runs agents in isolated environments with defined permissions
• Resource management: Controls CPU, memory, and network usage
• Dependency handling: Automatically manages required packages and tools
• Telemetry: Collects performance metrics and logs
• Access control: Integrates with your identity management systems

Getting Started

To start using Kubiya runners, decide whether hosted or local runners best meet your needs:

Next Steps

• Learn how to create your first runner
• Understand runner permissions and security
• Explore advanced runner configurations