Getting Started

This guide will help you setup your first Buildkite pipeline. If you don’t have a Buildkite account you’ll first need to sign up. This guide uses GitHub but Buildkite can work with any version control system.

Start your first agent

Once you’ve logged in, follow the instructions on the Agents page to install and start an agent. You can do this on your local development machine, an existing CI machine, or a new server.

Buildkite agent setup buttons

Add the sample pipeline

We’ve created a bash-example test repository to use as your first pipeline. Click the “Add to Buildkite” button below to open a new pipeline page for the example pipeline:

Add Bash Example to Buildkite

Create your first build

Now that you’ve started an agent and created a pipeline you’re ready to run your first build. Click the New Build button in the top right corner:

New build button

Type in a build message (being sure to add some emojis) and click Create Build:

New build dialog

You should now see the build start to run, and once it’s finished it should turn green!

Green build

Congratulations, you have run your first Buildkite build! 🎉

Invite your team to the organization

To invite your team so they can see your build, go to your organization’s Settings, and under Users you’ll be able to paste in their email addresses.

Using a private repository

When you create a new pipeline with a private repository URL you’ll be shown instructions for configuring your SCM’s webhooks (in GitHub, BitBucket, etc). Once you’ve followed those instructions make sure your agent’s SSH keys are configured, and you’ll be good to run a build of your private pipeline.

For more advanced pipelines it can be a good idea to use your development machine as the agent for your first few builds. That way all the dependencies are ready and you’ll sooner be able to share a link to a green build with the rest of your team.