Hosted Runners

Hosted runners are fully-managed execution environments provided by Kubiya. They require no installation or maintenance and are automatically provisioned when you sign up for the platform.

What Are Hosted Runners?

Hosted runners are deployed and maintained by Kubiya in secure, isolated cloud environments. They provide:

• Zero-setup execution environments for agent tools
• Automatic scaling to meet demand
• Regular security and performance updates
• Simplified onboarding experience

Provisioning Process

When you sign up for Kubiya, a hosted runner is automatically provisioned for your account. The process involves:

1. Initialization: The system begins creating your runner environment
2. Configuration: Runner resources are allocated and configured for your account
3. Connection: The runner establishes a secure connection to the Kubiya platform
4. Verification: System checks ensure the runner is functioning properly
5. Activation: The runner is made available for your agents to use

During this process, you'll receive status notifications in the platform:

• Provisioning in progress: Your runner is being set up
• Provisioning successful: Your runner is ready to use
• Provisioning failed: There was an issue setting up your runner (with troubleshooting steps)

Capabilities and Limitations

Hosted runners provide a convenient starting point but have some limitations compared to local runners:

Capabilities

• Execute standard agent tools
• Access public internet resources
• Integrate with publicly accessible APIs
• Run containerized workloads

Limitations

• Cannot directly access your internal network resources
• Limited ability to customize the execution environment
• Fixed resource allocations
• No ability to apply custom security policies

Use Cases

Hosted runners are ideal for:

• Evaluation and testing: Quickly try Kubiya without infrastructure setup
• Simple integrations: Workflows that only need publicly accessible services
• Development environments: Non-production deployments for building and testing agents
• Public cloud management: Managing resources in public cloud providers via their APIs

Security Considerations

Hosted runners operate with the following security measures:

• Isolated execution environments for each customer
• Tool execution in ephemeral containers
• Encryption for data in transit and at rest
• Regular security patching and updates
• Limited permission scope

Runner Status

You can check the status of your hosted runner in the Kubiya platform:

1. Navigate to the Runners section
2. Look for the "Hosted Runner" entry
3. Check its current status (Connected, Disconnected, or Error)

If you encounter any issues with your hosted runner, contact Kubiya support for assistance.

When to Switch to Local Runners

Consider moving to local runners when:

• You need to access resources in your private network
• You have strict security or compliance requirements
• You're deploying to production environments
• You need greater control over resource allocation and scaling
• You're implementing advanced security policies and controls

Next Steps

• Learn about local runners for advanced deployment options
• Configure your first agent to use the hosted runner
• Understand runner architecture and how it fits into the Kubiya platform