Self-hosted runner

Use your own infrastructure to run jobs.

Choose self-hosted runner if your team is looking for:

Privileged access & controls

Get more control over the environment for your jobs:

  • Connect to private networks
  • Monitor the operating system
  • Restrictions using static IPs
  • IAM permissions

Unique platform support

Build what you want, where you want. Runner supports:

  • Embedded systems
  • Custom compute types
  • Pre-installed licensed software

Use self-hosted runner alongside CircleCI Cloud hosted compute

Save engineering time by eliminating maintenance overhead.

See available execution environments

How self-hosted runner works:

Step 1 Runner software is installed on your machines.
Step 2 The runner polls CircleCI for jobs.
Step 3 Status and output are reported back to CircleCI and appear in the UI.

Install self-hosted runner your way

CircleCI’s self-hosted runner is available in both machine and container execution environments, which enables you to build and test on a wider variety of architectures, as well as have additional control over the environment.

Machine runner

Use a virtual or physical machine environment with machine runner.

Learn more

Container runner

Use a Kubernetes environment to run containerized CI/CD jobs.

Learn more

Need everything on your own infrastructure?

Learn how to get the power of CircleCI on-premises.

Learn About Server
close

Thank You for Submitting Your Info


You should receive an automated response notifying you that we received your info. Someone from our Enterprise team will be reaching out to you shortly.


CircleCI Success Logo