---
updatedAt: 2026-05-21T09:14:56.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/installation/llms.txt
---

# Before You Begin

Enable Nexus script execution, install Docker 20+ on the Nexus host, and ensure Artifactory has sufficient temp cache for migration.

## System Requirements

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

* A fully-configured Artifactory instance. For more information on installing Artifactory, see [Installing Artifactory](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. The minimum required space is calculated as: **largest file size × number of threads**. 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 the temp cache directory is 1200 MB.
* Script execution is enabled in Nexus Repository Manager. For more information, refer to <a href="https://support.sonatype.com/hc/en-us/articles/360045220393-Scripting-Nexus-Repository-3#how-to-enable" target="_blank">Nexus Repository Manager Documentation</a>.
  <Callout icon="📘" theme="info">
    Enabling script execution requires restarting the Nexus server.
  </Callout>
  A warning appears in Nexus Repository Manager after you enable script execution. Run the migration tool from the Nexus Repository Manager host machine.
* Verify that the following directories exist on the Nexus Repository Manager host machine:
  * `$datadir/etc` and `$datadir/blob` for Nexus 3.
  * `$datadir/conf` and `$datadir/storage` for Nexus 2.
* The user who runs the migration must have root privileges.
* This is optional. For Nexus 3, if you are running the tool from an external machine, execute the following command:
  ```bash
  export SKIP_MIGRATION_FILESYSTEM_CHECK=true
  ```
  To configure, set the URL to:
  ```xml
  http://<private ip>:<port>
  ```
  If a context path is configured for the Nexus server, use:
  ```xml
  http:<private ip>:<port>/<context-path>
  ```
  <Callout icon="📘" theme="info">
    Nexus 2 does not support this feature as the tool relies completely on filesystem data.
  </Callout>

## Prerequisites

* 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 set up with self-signed SSL certificates, create the following directory and copy the certificates into it.

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

## Related Topics

* [Nexus Repository Manager Migration to JFrog Artifactory](migrating-from-sonatype-nexus-repository-manager-to-artifactory)
* [Migrator Tool Overview](migrator-tool-overview)
* [Migration Process](migration-process)
* [Run the Migration Tool in a Single Step](run-the-migration-tool-in-a-single-step)
* [Run the Migration Tool in Multiple Stages](run-the-migration-tool-in-multiple-stages)
* [Installing Artifactory](installing-artifactory)