Creating a New Replication Connection

Only available in Nexus Repository Pro. Interested in a free trial?  Start here.


NEW IN 3.34.0

We are redesigning replication in 2022 to remove Replicator and make it easier to set up and deploy. Once we release the new implementation, we will no longer support the replication method detailed here.

  1. Before creating a new replication connection, ensure you have satisfied all prerequsites.

    Prerequisites include but are not limited to the following:

    • Source and target instances must be on the same Nexus Repository Pro version.

    • Source and target repositories must be one of the following formats:

      • Docker 
        NEW IN 3.35.0
      • Maven hosted
      • npm 
        NEW IN 3.35.0
      • NuGet 
        NEW IN 3.37.0
      • PyPI 
        NEW IN 3.37.0
      • Raw

    • Source and target repository blob stores cannot be part of a blob store group.
    • The source and target repositories must be locally mounted on the machine where the Replicator runs for file replication.
    • Source repository must be able to send HTTP requests to the target Nexus Repository instance during the initial configuration process.
    • Repository replication is not compatible with the legacy High Availability Clustering (HA-C) feature.


  2. In the source instance (the repository from which you want to replicate components), navigate to Administration   Repository   Replication .
  3. Click New Replication ; the New Replication configuration form displays.
  4. Provide a unique name for the replication.
  5. Select an option for all existing content or only filtered content.
  6. Under Source Repository Name , select the repository from which you would like content to be replicated.
  7. Under Instance URL, provide the target instance URL and port to which content should be replicated. The target instance URL is the root URL of the instance.
  8. Provide a username and password for your target instance under User Authentication. This user should have the Replication Administrator role.
  9. If desired, check the checkbox for Use certificate connected to the Nexus Truststore. This tells your source Nexus Repository instance to use the Nexus Truststore for certificates when contacting the remote Nexus Repository. 
    NEW IN 3.36.0
     See Configuring SSL for more information on adding Truststore certificates.
  10. Select the Test Repository Connection button. This triggers the source instance to communicate with the target instance using the authentication credentials provided. If the connection is successful, a list of the available target repositories displays inside a drop-down menu on the form.
  11. From the Target Repository Name drop-down menu, select the target repository for the replication.

    Ensure the target repository is a newly created hosted repository of the supported formats. As a best practice, do not use a target repository that has previously uploaded binaries. This allows you to more easily manage your storage requirements for replicated content. Note also that the target repository will be read-only to all other requests as long as it is configured as a target repository.

  12. Select Create Replication Connection to finish the configuration.

A newly created replication connection now displays under Current Connections on the Replication page. If configured, any existing data in the repository is queued for replication and content will start replicating once the Replicator is running.

You should proceed to running the Replicator.