We use cookies to understand how people use Depot.
Guides

Troubleshooting

Resetting build cache for a project

Each project in Depot comes with a persistent build cache that is shared among all systems and users that build it. The cache allows for certain steps in your Dockerfile to be skipped in subsequent runs if their associated layer hasn't changed since the last time it was built. There can be times when you want to purge this cache.

  • The build is hung because of a deadlock in BuildKit
  • A builder isn't coming online to serve the build request
  • The build cache is full and needs to be cleared

We optimize Depot so that these issues happen rarely. However, if you're seeing any of these issues, you can reset the build cache for a project. Resetting the build cache purges the cache volume and launches a new build machine with a clean slate. You can reset the build cache for a project via these steps:

  1. Go to the project's Settings page
  2. Click the Reset build cache button at the bottom