Bitbucket pipeline build error with respect to self-hosted runners configuration

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Encountering a common build error attributed to the incorrect configuration of self-hosted runners while attempting to run builds.

1 The Docker feature is not supported on this self-hosted runner's platform.

Cause

  • Runner is not online.

  • The definition of the runner label in the YAML is incorrect.

Solution

  • Verify the status of the runner by navigating to Workspace Settings > Runners (for runners configured on Workspace) or Repository Settings > Runners (for runners configured on the repository).

Reference: Adding a New Runner in Bitbucket

  • Verify the definition of the runner label under the runner's settings matches the pipeline's YAML file.

    Example: Runner's settings:

(Auto-migrated image: description temporarily unavailable)

Pipeline YAML file:

1 2 3 runs-on: - self.hosted - linux

Defining the label "linux.shell" instead of "linux" in the pipeline yaml file leads to the error "The Docker feature is not supported on this self-hosted runner's platform" in this case.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.