Documentation structure for LLMs (llms.txt)
CircleCI Logo

CircleCI’s self-hosted runner overview

1 day ago
Cloud Server

Use CircleCI’s self-hosted runner to run jobs on your own infrastructure. With runner, you can build and test on a wide variety of architectures, and gain additional control over the build environment.

Introduction

Self-hosted runner installation options are as follows:

  • Install in a Kubernetes cluster, using a container runner.

  • Install in a machine execution environment using a machine runner.

  • Automatically scale runner VMs in a Kubernetes cluster using Machine Runner Orchestrator.

The diagrams below illustrate how CircleCI’s container and machine runners extend our existing systems.

  • Container runner

  • Machine runner

CircleCI’s container runner architecture
Figure 1. Container runner architecture
CircleCI’s machine runner architecture
Figure 2. Machine runner architecture

CircleCI’s self-hosted runner operation

Once a self-hosted runner is installed, the runner polls circleci.com for work, runs jobs, and returns status, logs, and artifacts to CircleCI.

CircleCI runner use cases

CircleCI self-hosted runner is designed to meet the needs of two main use cases, as follows: