Branch-Based (Legacy) Dependency Caching Migration and New Size Limit

Changelog Website
1

As of Tuesday 13 May 2025, Bitrise is migrating projects using the old version of branch-based dependency caching to an updated version that includes a 15 GB per-entry size limit (per uploaded object, a single uploaded object can’t be larger than 15GB).

Branch-based dependency caching is a legacy system with limited performance and flexibility compared to key-based dependency caching. While most users have already moved to key-based dependency caching, some workflows still rely on the older setup.

To avoid disrupting those workflows, we are keeping branch-based dependency caching available with a size limit (15GB per object) in place. We continue to recommend migrating fully to key-based dependency caching for better performance and long-term support.

What to do:

  • If you are already using key-value dependency caching: No action needed, there’s no change for the key-value dependency caching system.
  • If you are still using branch-based dependency caching: We recommend migrating to key-based dependency caching as soon as possible for better performance, flexibility, and long-term support. Follow this guide to get started: Migrating from branch-based caching to key-based caching
    • If your cache archive is under 15 GB:
      Your workflow has been automatically migrated to the updated version of branch-based dependency caching, no action required at this time. However, we still recommend switching to key-based dependency caching to take full advantage of improved dependency caching performance, features and for long term support.
    • If your dependency cache archive exceeds 15 GB: A small number of users still using branch-based dependency caching have cache archives exceeding 15 GB. These workflows will be migrated separately at a later date (in November 2025). In the meantime, we recommend either reducing your cache size or moving to key-based dependency caching to avoid skipped cache steps and benefit from improved performance.

:backhand_index_pointing_right: Learn more and migrate manually if needed: Migrating from branch-based caching to key-based caching

:thinking: Do you have a question? Let us know by leaving a comment, or by contacting support.