Docker failed to initialize due to xfs filesystem format on Linux in Bitbucket Cloud

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

Summary

The user is unable to start docker due to xfs filesystem on Linux. The error being received is:

Error: failed to start daemon: error initializing graphdriver: overlay2: the backing xfs filesystem is formatted without d_type support, which leads to incorrect behavior. Reformat the filesystem with ftype=1 to enable d_type support. Backing filesystems without d_type support are not supported

Environment

Attempting to run pipelines for Bitbucket Cloud.

Solution

This behavior is a limitation of docker which will require the disk to be reformatted with a new XFS filesystem with d_type support enabled.

Please refer to the links below for detailed steps on how to perform the same:

Updated on March 5, 2025

Still need help?

The Atlassian Community is here for you.