Edit on GitHub

cache migrate

Migrate existing cache data to the DVC 3.0 location.


usage: dvc cache migrate [-h] [-q | -v] [--dry]


Forces migration of cache data for files which were tracked in older DVC releases to the DVC 3.0 location. Files from the old cache location will be re-hashed using the DVC 3.0 hash algorithm, atomically moved to the new cache location, and then a link will be created from the old location to the new one.

On most local filesystems, this is equivalent to the de-duplication of files tracked in DVC 3.0 and files tracked in older releases.

On filesystems that do not support any type of linking, data will be copied from the old cache location into the DVC 3.0 location (resulting in no de-duplication).


  • --dry - Only print actions which would be taken without actually migrating any data.

  • -h, --help - prints the usage/help message, and exit.

  • -q, --quiet - do not write anything to standard output. Exit with 0 if no problems arise, otherwise 1.

  • -v, --verbose - displays detailed tracing information.

Example: Check the steps which will be taken before migrating

$ dvc cache migrate --dry
94975 files will be re-hashed and migrated to the DVC 3.0 cache location.

Example: Migrate existing cache

$ dvc cache migrate
Migrated 94975 files to DVC 3.0 cache location.

🐛 Found an issue? Let us know! Or fix it:

Edit on GitHub

Have a question? Join our chat, we will help you:

Discord Chat