Get started with Bitbucket Pipelines

The easiest way to start with Bitbucket Pipelines is to follow the steps in our configuration wizard.

See also:


Step 1: Enable Bitbucket Pipelines

Click the Pipelines icon to start the wizard. If you're viewing Pipelines for the first time, click Enable Pipelines in the welcome screen:

  1. Bitbucket Pipelines
  2. Get started!

Note: Make sure that your repository isn't empty before going to the next step. Pipelines can't be enabled for an empty repository.



Step 2: Pick a template

The bitbucket-pipelines.yml file contains the definition of your build. On this stage, we've already enabled Pipelines for your repository. Select a template and click Next to open it in the Bitbucket editor:

  1. Pick an example
  2. Edit in Bitbucket



Step 3: Customize your configuration

The bitbucket-pipelines.yml configuration file lives in the root of each branch in your repository.

We'll copy the content of the example and put it in the right place for you:

  1. Select a branch
  2. Customize
  3. Run a pipeline!

That's it! Commit to trigger your first pipeline.



I don't want to use the wizard to commit the file
  1. Pick an example from Language guides and customize it.
    At this stage, you might want to Debug your pipelines locally with Docker.
  2. Commit it to the root of your repository, on a branch of your choice.
  3. Enable Pipelines:
    1. Go to a repository that belongs to an account for which you enabled Bitbucket Pipelines. 
    2. Click Pipelines in the menu on the left.
    3. Switch the toggle to Enabled.

To trigger a build, push a change after you've enabled Pipelines.



Got the basics, what's next?

Have a look at our main page for further configuration guidelines.



Last modified on Aug 28, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.