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:

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.
Was this helpful?