macOS hosted agents

macOS instances for Buildkite hosted agents are only offered with Apple silicon architecture. Please contact support if you have specific needs for Intel machines.

To accommodate different workloads, instances are capable of running up to 4 hours. If you require longer running agents, please contact support at support@buildkite.com.

Sizes

Buildkite offers a selection of macOS instance types (each based on a different size combination of virtual CPU power and memory capacity, known as an instance shape), allowing you to tailor your hosted agents' resources to the demands of your jobs.

Instance shape Size vCPU Memory
Instance shape Instance shape MACOS_M2_4X7 Size Size Small vCPU vCPU 4 Memory Memory 7 GB
Instance shape Instance shape MACOS_M2_6X14 Size Size Medium vCPU vCPU 6 Memory Memory 14 GB
Instance shape Instance shape MACOS_M2_12X28 Size Size Large vCPU vCPU 12 Memory Memory 28 GB
Instance shape Instance shape MACOS_M4_12X56 Size Size Extra Large vCPU vCPU 12 Memory Memory 56 GB

Extra large instances are available on request. Please contact support@buildkite.com to have them enabled for your account.

macOS instance software support

All standard macOS Sequoia and Sonoma instances have their own respective Xcode and runtime software available by default (listed below). For each of these macOS versions, the Homebrew packages and their versions (listed further down) are also available. If you have specific requirements for software that is not listed here, please contact support.

Updated Xcode versions will be available one week after Apple offers them for download. This includes Beta, Release Candidate (RC), and official release versions.

macOS Sequoia

  • 15.1

Xcode

  • 16.2-RC
  • 16.2
  • 16.1
  • 16.0
  • 15.4

Runtimes

iOS

  • 18.2 RC
  • 18.1
  • 18.0
  • 17.5
  • 16.4
  • 15.5

tvOS

  • 18.2 RC
  • 18.1
  • 18.0
  • 17.5
  • 16.4

visionOS

  • 2.2 RC
  • 2.1
  • 2.0
  • 1.2
  • 1.1
  • 1.0

watchOS

  • 9.4
  • 11.2 RC
  • 11.1
  • 11.0
  • 10.5

macOS Sonoma

  • 14.6.1

Xcode

  • 16.2-RC
  • 16.2
  • 16.1
  • 16.0
  • 15.4
  • 15.3
  • 15.2
  • 15.1
  • 14.3.1

Runtimes

iOS

  • 18.2 RC
  • 18.1
  • 18.0
  • 17.5
  • 17.4
  • 17.2
  • 16.4
  • 16.2
  • 15.5

tvOS

  • 18.2 RC
  • 18.1
  • 18.0
  • 17.5
  • 17.4
  • 17.2
  • 16.4

visionOS

  • 2.2 RC
  • 2.1
  • 2.0
  • 1.2
  • 1.1
  • 1.0

watchOS

  • 9.4
  • 11.2 RC
  • 11.1
  • 11.0
  • 10.5
  • 10.4
  • 10.2

Homebrew packages

Package Version
ant 1.10.15
applesimutils 0.9.10
aria2 1.37.0
awscli 2.22.17
azcopy 10.27.1
azure-cli 2.67.0_1
bazelisk 1.25.0
bicep 0.32.4
carthage 0.40.0
cmake 3.31.2
cocoapods 1.16.2
curl 8.11.1
deno 2.1.4
docker 27.4.0
fastlane 2.226.0
gcc@13 13.3.0
gh 2.63.2
git 2.47.1
git-lfs 3.6.0
gmp 6.3.0
gnu-tar 1.35
gnupg 2.4.6
go 1.23.4
gradle 8.11.1
httpd 2.4.62
jq 1.7.1
kotlin 2.1.0
libpq 17.2
llvm@15 15.0.7
maven 3.9.9
mint 0.17.5_1
nginx 1.27.3
node 23.4.0
openssl@3 3.4.0
p7zip 17.05
packer 1.11.2
perl 5.40.0
php 8.4.1_1
pkgconf 2.3.0_1
postgresql@14 14.15
r 4.4.2_2
rbenv 1.3.0
rbenv-bundler 1.0.1
ruby 3.3.6
rust 1.83.0
rustup 1.27.1_1
selenium-server 4.27.0
swiftformat 0.55.3
tmux 3.5a
unxip 3.1
wget 1.25.0
xcbeautify 2.16.0
yq 4.44.6
zstd 1.5.6

Git mirror cache

The Git mirror cache is a specialized type of cache volume designed to accelerate Git operations by caching the Git repository between builds. This is useful for large repositories that are slow to clone.

These volumes are attached on a best-effort basis depending on their locality, expiration and current usage, and therefore, should not be relied upon as durable data storage. By default, a Git mirror cache is created for each repository.

Enabling Git mirror cache

To enable Git mirror cache for your hosted agents:

  1. Select Agents in the global navigation to access the Clusters page.
  2. Select the cluster in which to enable the Git mirror cache feature.
  3. Select Cache Storage, then select the Settings tab.
  4. Select Enable Git mirror, then select Save cache settings to enable Git mirrors for the selected hosted cluster.

Once enabled, the Git mirror cache will be used for all hosted jobs using Git repositories in that cluster. A separate cache volume will be created for each repository.

Hosted agents git mirror setting displayed in the Buildkite UI

Deleting Git mirror cache

Deleting a cache volume may affect the build time for the associated pipelines until the new cache is established.

To delete a git mirror cache:

  1. Select Agents in the global navigation to access the Clusters page.
  2. Select the cluster whose Git mirror cache is to be deleted.
  3. Select Cache Storage, then select the Volumes tab to view a list of all exiting cache volumes.
  4. Select Delete for the Git mirror cache volume you wish to remove.
  5. Confirm the deletion by selecting Delete Cache Volume.