How to install Buildkite Agent

The Buildkite agent runs on your own machine, whether it's a VPS, server, desktop computer, embedded device. There are installers for:

Alternatively you can install it manually using the instructions below.

Manual installation

If you need to install the agent on a system not listed above you'll need to perform a manual installation using one of the binaries from buildkite-agent's releases page.

Once you have a binary, create bin and builds directories in ~/.buildkite-agent and copy the binary and file into place:

mkdir ~/.buildkite-agent ~/.buildkite-agent/bin ~/.buildkite-agent/builds
cp buildkite-agent ~/.buildkite-agent/bin
cp ~/.buildkite-agent/

You should now be able to start the agent:

buildkite-agent start --help

If your architecture isn't on the releases page send an email to support and we'll help you out, or check out the buildkite-agent's readme for instructions on how to compile it yourself.

Upgrade agents

To update your agents, you can either:

  • Use the package manager for your operating system.
  • Re-run the installation script.

As long as you're using Agent v3 or later, no configuration changes are necessary.