Before you begin

JFrog Installation & Setup Documentation

Content Type
Installation & Setup

System Requirements

Before beginning migration, verify that the following system requirements are in place.

  • A fully-configured Artifactory instance. For more information on installing Artifactory, see Installing Artifactory.

  • The Artifactory host machine must have enough space to handle the temp cache directory of Nexus Migrator if the Nexus Repository uses the S3 blob store. You can get the minimum required space for temp cache directory with the following formula:

    The Artifactory instance must have additional memory equivalent to this value over the memory in the Nexus Repository instance. For example, if the largest file in the repository is 300 MB and the number of threads in the Artifactory machine is 4, the minimum space requirement for temp cache directory is 1200 MB.

  • Script execution is enabled in Nexus Repository Manager. For more information, refer to Nexus Repository Manager Documentation. A warning appears in Nexus Repository Manager after you enable script execution. You must run the migration tool from the Nexus Repository Manager host machine.

  • Ensure that the following directories exist in the Nexus Repository Manager host machine:

    • $datadir/etc and $datadir/blob for Nexus 3.

    • $datadir/conf and $datadir/storage for Nexus 2.

  • The user that runs migration must have root privileges.


Migration is supported only from a Nexus Repository Manager instance running on a Linux machine.


  • Install Docker (version 20 or later) in the machine that hosts Nexus Repository Manager.

  • The user in the Artifactory machine and the Nexus Repository Manager machine must have administrator privileges.

Working with Artifactory on self-signed SSL certificates

If your Artifactory is setup with self-signed SSL certificates, you need to create the following directory and copy the certificates under it.

mkdir -p <working directory>/migration/security/certs