Buildkite Agent

by buildkite


buildkite-agent Heroku app

An example of running the buildkite-agent on a Heroku dyno using the buildkite-agent build pack.

The agent will run with heroku=true metadata applied.


Deploy to Heroku

Press the button above, provide your agent token, then hit "Deploy". Once it's deployed, click on "Manage App" and scale up the agent process to at least 1.

You should see your Buildkite agent dashboard register the new agent.

To set it up on Heroku manually without the button, follow these instructions instead:

# Create a dyno
$ heroku create my-buildkite-agent \

# Put in your token and any metadata for targeting the agents
$ heroku config:set BUILDKITE_AGENT_TOKEN=xxx \

# :rocket:
$ git push heroku master

# Spin up an agent on a 1x dyno
$ heroku scale agent=1

# Tail the logs
$ heroku logs -t

# Spin up an squadron of 2x agent dynos
$ heroku scale agent=24:2X


You can fork this repo and add your own hooks into a directory specified by a BUILDKITE_HOOKS_PATH var you set.