Get started with Bitbucket Pipelines

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



On this page

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:

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:



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:

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.

  I want to test the configuration locally first



Got the basics, what's next?

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




Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport