Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How to use parallel steps?

MennoVink
Contributor
March 25, 2026

Here's a subsection of my bitbucket-pipelines.yml:

pipelines:
branches:
release:
- parallel:
- step: *BuildWindows
- step: *BuildMacOS
- step: *BuildDocumentation
- step:
name: Upload
deployment: Develop

This setup is intended to have builds running on three machines/platforms simultaneously. (Documentation is built on linux)

The definitions for these steps each target a different self-hosted machine that is currently idle like so:

definitions:
steps:
- step: &BuildWindows
name: Build Windows
runs-on:
- 'self.hosted'
- 'windows'

 

This page states that free plan users can have up to 10 parallel steps: https://support.atlassian.com/bitbucket-cloud/docs/parallel-step-options/

 

In my experience, these steps execute sequentially. Any idea what i might be doing wrong? I have run out of build minutes (trying qodana), but since these steps run on self.hosted runners that should be fine, sequential builds to work.

2 answers

0 votes
Mark C
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 27, 2026

Hi @MennoVink

Thank you for reaching out to the community.

Based on the YAML configuration, it seems you're missing the "steps" property in your parallel steps.

It should be like this:

Screenshot 2026-03-27 at 6.03.47 pm.png

Regards,
Mark C

0 votes
Aron Gombas _Midori_
Community Champion
March 26, 2026

@MennoVink 

Two ideas:

  1. Check if all three self-hosted runners are online and in an idle state at the time the pipeline triggers. You can check runner status under Repository Settings > Runners.
  2. Wait for your build minutes to reset, and then test the parallel block again.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin Site Admin
TAGS
AUG Leaders

Atlassian Community Events