Pipeline build failed with The Docker feature is not supported on this self-hosted runner's platform error

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

Summary

Error stating "Configuration error - The Docker feature is not supported on this self-hosted runner's platform"

Platform: Bitbucket Pipeline Self-hosted Runners - All Shell based

Solution

Possible cause:

You may be utilizing runners that currently don’t support the use of service containers, such as the Docker service. This limitation can be confirmed by referring to the respective Runner Unsupported Features section. The following runners don't support service containers:

Troubleshooting steps:

  • To utilize service containers, it is recommended to use Runners that support them, such as Linux Docker.

  • If you wish to utilize an existing Runner that does not support service containers, you must remove the service container from the Bitbucket Pipeline YAML file (bitbucket-pipelines.yml).

Updated on March 25, 2025

Still need help?

The Atlassian Community is here for you.