Key Points for File Transfer:

ARTIFACTORY: Artifactory Migration using JFrog CLI Transfer Tool

Products
Frog_Artifactory
Content Type
User_Guide
AuthorFullName__c
Emmanuel Ouzan, David Livshin, Daniel Milman
articleNumber
000006688
FirstPublishedDate
2025-11-16T09:15:07Z
lastModifiedDate
2025-11-13
VersionNumber
2
  • Remote repository cached artifacts are not transferred. If you wish to include cached remote repository content you can first manually copy the content of the remote cache to a local repository using the UI, API or CLI. This will then be transferred to the new Artifactory.
  • Files created or modified on the source after the transfer starts are transferred, along with their custom properties if the file content also changed.
  • Files deleted on the source after the transfer starts are not deleted on the target.
  • If only a file's custom properties change on the source (not its content), these property changes are not updated on the target.
  • Federated repositories are transferred without their federation members. After the transfer, you'll need to reconfigure the federation members as described in the Federated Repositories documentation.
  • Since the files are pushed from the source to the target instance, the source instance must have a network connection to the target.

In order to transfer the artifacts we need to run the following commands:

  1. Checking the connectivity between the two servers by using the --prechecks=true flag:
    jf rt transfer-files source-server target-server --prechecks=true
  2. If the above prechecks command completes successfully, we can run the full command 
    jf rt transfer-files source-server target-server 

    Example of the output you should be seeing when running the transfer-files command:

    User-added image 
  3. We can use the following command to get the status of the transfer
    jf rt transfer-files --status

     

    Example output:

    User-added image
     
  4. You can also control the number of working threads in the migration by running the jf rt transfer-settings command, themore threads used, the more load there will be on the source Artifactory, you must monitor your usage to see what is the best balance in your situation:
    jf rt transfer-settings

    The default value is 8 but can be changed even during the file transfer. 
    User-added image 
     
  5. Once the process is completed, you should get a message it was completed successfully:

User-added image

For more information about Controlling the transfer speed with the its considerations, please head to Controlling the File Transfer Speed documentation