Buildkite hosted agents

Buildkite hosted agents provides a fully-managed platform on which you can run your agents, so that you don't have to manage agents in your own self-hosted environment.

With hosted agents, Buildkite handles infrastructure management tasks, such as provisioning, scaling, and maintaining the servers that run your agents.

Hosted agent types

Buildkite offers both Mac and Linux hosted agents.

Usage of all instance types is billed on a per-minute basis.

Every Buildkite hosted agent within a cluster benefits from hypervisor-level isolation, ensuring robust separation between each instance.

Creating a Buildkite hosted queue

You can set up distinct queues for your Buildkite hosted agents (known as Buildkite hosted queues), each configured with a specific type and size of hosted agent, to efficiently manage jobs with varying requirements. Learn more about how to do this in Create a Buildkite hosted queue.

For example you may have two queues set up:

  • mac_small_7gb
  • mac_large_32gb

Learn more about:

Using GitHub repositories in your hosted agent pipelines

Buildkite hosted agent services support both public and private repositories. Learn more about setting up code access in Hosted agent code access.

Migrating your pipelines to hosted agent services

Learn more about migrating existing pipelines to Buildkite hosted agent services in Hosted agent pipeline migration.

Accessing machines through a terminal

When a Buildkite hosted agent machine is running (during a pipeline build) you can access the machine through a terminal. Learn more about this feature in Hosted agents terminal access.

Secret management

Buildkite secrets is a Buildkite secrets management feature designed for Buildkite hosted agents, and is available for self-hosted agents too.

This feature can be used to manage secrets such as API credentials or SSH keys for hosted agents. Learn more about this feature in Buildkite secrets.