Configure your first pipeline

There are two ways to configure your pipeline: you can either directly write the YAML file or you can use the UI wizard provided by Bitbucket. The steps below will guide you through the Pipelines configuration wizard.


  • You need to have a Bitbucket Cloud account.

  • Your workspace must have at least one repository.


  1. In Bitbucket, go to your repository and select Pipelines.

  2. Click Create your first pipeline to scroll down to the template section.

  3. Choose one of the available templates. If you aren’t sure, you can use the one RECOMMENDED.

Templates cover a variety of use cases and technologies such as apps, microservices, mobile IaaC, and serverless development. We support major cloud providers such as AWS, Azure, and GCP. We support the top-used languages such as NodeJS, PHP, Java, Python, and .NET Core; however, based on the language configured in your Bitbucket repository, the template list automatically recommends templates in that language.


4. Once you choose a template, you will land in the YAML editor where you can configure your pipeline. Learn more about YAML syntax.


Change template

You can change the template anytime by opening the dropdown and selecting a different template. Keep in mind that if you choose a new template, it will override the existing content.


Add more steps

You can easily add more steps. Hover over the options in the steps panel and copy the code snippet, then add it to the editor.


Add Pipes

Pipes allow you to easily configure a pipeline with third-party tools. Learn more about pipes.

To use a pipe you just have to select the pipe you want to use, copy, and paste the code snippet in the editor. There are dozens of pipes, see the full list by clicking Explore more pipes.


Add variables

You can define custom variables that you can use in the YAML file. To add a variable, fill in the name, the value, check whether you want to encrypt it by clicking the secured box, and click Add.



Now that you’ve configured your first pipeline, you can always go back to the yaml editor by clicking the pipeline cog icon. Learn more about the Pipeline screen here.

Still need help?

The Atlassian Community is here for you.