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.
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.
Open the command line tool available on your OS. You could use PowerShell for Windows, or Terminal for Mac and Linux.
pip --versioncommand to verify that you have pip up and running.
If you encounter problems, ensure you can run pip from the command line.
pip install uploadcare-migro.
Congratulations! Now we are ready to run Migro.
- 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.txtcontaining the following:
https://cdn.filestackcontent.com/resize=width:1200/0zOaZQULQkerFOfwCyGU https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Olives_et_piments.jpg /1280px-Olives_et_piments.jpg https://giphy.com/clips/CloieWyattTaylor-coffee-i-need-cloie-wyatt-taylor-D9d49 zzEPhh3sWRW7g https://media.giphy.com/media/51Uiuy5QBZNkoF3b2Z/giphy-downsized-large.gif
Make sure you already have an Uploadcare account and a project created to keep files you plan to migrate.
https://app.uploadcare.com/projects/<your project id>/api-keys/.
Copy your public key.
- 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
- 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 firstname.lastname@example.org in case of any questions.
- Investigate this
migro_result.txtfile 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.
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.