Resolving "Cache key files could not be found" error on Bitbucket pipelines

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

Summary

Users might observe "Cache key files could not be found" error during build set up step on pipelines which results in failure of the build

1 2 3 Key file does not exist – Cache key files could not be found. Key file is outside the repository – Cache key files could not be found.

Cause

  • Providing incorrect path to the file in YAML config

  • Error in the file name defined

  • Presence of lock files

Solution

Updated on April 11, 2025

Still need help?

The Atlassian Community is here for you.