Self-Hosted Runners
Run tests on your own infrastructure with theroboticks-runner CLI agent.
What are Self-Hosted Runners?
Self-hosted runners are agents that connect to the Roboticks platform, poll for test jobs, and execute them in Docker containers on your own machines. This gives you full control over the execution environment while leveraging the Roboticks platform for orchestration and reporting.Key Features
Self-Hosted
Run tests on your own machines, on-premises or in the cloud
Docker Isolation
Test execution isolated in Docker containers for consistency
Concurrent Jobs
Execute multiple jobs in parallel (up to 10 per runner)
Secure
Token-based authentication with automatic rotation
How It Works
Requirements
| Requirement | Details |
|---|---|
| Docker | Docker Engine must be installed and running |
| Network | Access to api.roboticks.io (HTTPS port 443) |
| OS | Linux, macOS, or Windows |
When to Use Self-Hosted Runners
Self-hosted runners are ideal when you need:- Custom hardware: GPUs, ARM processors, or specialized equipment
- Network access: Tests that require access to internal resources
- Compliance: Data must stay within your infrastructure
- Performance: Dedicated resources for faster execution
- Cost optimization: Use existing infrastructure
Quick Start
Get a runner up and running in minutes:Get a registration token
Go to Settings > Fleet > Self-Hosted Runners in the dashboard and click Add Runner
Runner Commands
| Command | Description |
|---|---|
register | Register the runner with Roboticks |
start | Start the runner daemon |
status | Show runner status and configuration |
run-job | Execute a single job (for EC2/CI environments) |
version | Print version information |