Installing Buildkite Agent on FreeBSD

Installation

FreeBSD allows you to install Buildkite Agent using the pkg package manager.

pkg install buildkite-agent

Configure your agent token:

sudo sed -i "s/xxx/INSERT-YOUR-AGENT-TOKEN-HERE/g" /usr/local/etc/buildkite/buildkite-agent.cfg

Then, start the agent:

buildkite-agent start

Alternatively you can follow the manual installation instructions.

SSH key configuration

SSH keys should be copied to (or generated into) ~/.ssh/ for the user the agent is running as. For example, to generate a new private key which you can add to your source code host:

$ mkdir -p ~/.ssh && cd ~/.ssh
$ ssh-keygen -t rsa -b 4096 -C "build@myorg.com"

See the Agent SSH keys documentation for more details.

File locations

• Configuration: /usr/local/etc/buildkite/buildkite-agent.cfg
• Agent Hooks: /usr/local/etc/buildkite/hooks
• Builds: /usr/local/var/buildkite/builds
• SSH keys: ~/.ssh

Configuration

The configuration file is located at /usr/local/etc/buildkite/buildkite-agent.cfg. See the configuration documentation for an explanation of each configuration setting.

Upgrading

pkg upgrade buildkite-agent