How to transfer your files to Uploadcare

When moving your files to Uploadcare from other instruments, the need to transfer all files might look scary. Especially, if you have thousands of files. However, this doesn’t have to be a manual migration. Uploadcare has created the Migro tool to serve this purpose. This solution works both when you move from another CDN, or from a DIY solution.

Migro library on GitHub

Install Migro

  1. Ensure you have Python installed on your computer. Or you can download and install the latest version. Migro requires Python version 3.8 or higher.

  2. Open the command line tool available on your OS. You could use PowerShell for Windows, or Terminal for Mac and Linux.

  3. Run pip --version command to verify that you have pip up and running.

  4. If you encounter problems, ensure you can run pip from the command line.

  5. Run pip install uploadcare-migro.

Congratulations! Now we are ready to run Migro.

Run Migro

  1. Create a text file somewhere on your computer with the links to all files you want to move to Uploadcare. For the purpose of this guide, it’s going to be files-for-uploadcare.txt containing the following:
  1. Make sure you already have an Uploadcare account and a project created to keep files you plan to migrate.

  2. Navigate to<your project id>/api-keys/.

  3. Copy your public key.

Uploadcare public key
  1. Open your command line tool and run the following command:
migro <your public key> <path to file with links>

          In our case, this was:

migro 7c3e642799177971a49c files-for-uploadcare.txt
  1. Wait for Migro to finish the transfer. You’ll see something like the following notice after the completion:
migro 7c3e642799177971a49c files-for-uploadcare.txt
Upload progress: 100%|███████████████████████████████████████████████████
███████████████████████████████████████| 4/4 [00:01<00:00,  3.58file/s]
All files have been processed, output URLs were written to: 
are here: /home/uploadcare/migro_result.txt
Number of failed files: 1
Thanks for your interest in Uploadcare.
Hit us up at in case of any questions.
  1. Investigate this migro_result.txt file for additional information about the files transfer. In the example above there is one failure: we tried to upload one non-image file to an unverified Uploadcare account. Verified accounts accept files of any type.

Congratulations! You’ve just finished your file transfer. To discover more information about Migro capabilities, please read the instrument’s README.

Or use Uploadcare without moving

If you are interested in Uploadcare features but not ready to move your files yet, please consider our Proxy. The Proxy will allow you to keep your files where they are and get access to our CDN and operations, like image processing.