Get started with Bitbucket Pipelines
The easiest way to start with Bitbucket Pipelines is to follow the steps in our configuration wizard.
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:
- Bitbucket Pipelines
- 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:
- Pick an example
- 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:
- Select a branch
- Run a pipeline!
That's it! Commit to trigger your first pipeline.
- Pick an example from Language guides and customize it.
At this stage, you might want to Debug your pipelines locally with Docker.
- Commit it to the root of your repository, on a branch of your choice.
- Enable Pipelines:
- Go to a repository that belongs to an account for which you enabled Bitbucket Pipelines.
- Click Pipelines in the menu on the left.
- 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.