Skip to content

Guides

How to work around the 10 GB cache limit

Your caches exceed 10 GB per repository and start silently evicting.

5 min read

Your caches exceed 10 GB per repository and start silently evicting.

Why it happens

GitHub caps Actions cache at 10 GB and evicts least-recently-used entries once you cross it. Builds keep passing, they just get slower.

How to fix it

  1. Measure total cache size per repository before assuming you are under the cap
  2. Split caches so hot entries are not evicted by cold ones
  3. Compress with zstd rather than the default
  4. Move to a provider without a per-repository cap if you are structurally over it

Your next build could be twice as fast, at half the price

Start free. Migrating away is the same one line, and we publish that diff too.