Migrate from Nexus 3 to RepoFlow

Use automatic migration in RepoFlow for a guided transfer, or keep using the legacy RepoFlow CLI for existing workflows.

Overview

RepoFlow can automatically migrate supported repositories from Nexus Repository 3. This guide covers the built-in migration flow, the legacy RepoFlow CLI option, validation, cutover, and decommissioning.

Automatic migration in RepoFlow

RepoFlow now includes automatic repository migration in the product. For new migrations, use the guided RepoFlow migration flow to connect Nexus 3, select the repositories you want to move, and track the transfer from RepoFlow.

Supported package types

Automatic migration from Nexus 3 currently supports:

  • npm
  • PyPI
  • Maven (maven2)
  • NuGet
  • Cargo
  • Go
  • Helm
  • Docker
  • RPM (yum)
  • Gems (rubygems)

Open RepoFlow to start a migration

Legacy RepoFlow CLI migration tool

The standalone RepoFlow CLI migration tool remains available for existing scripts and CLI-based workflows. It is the legacy option. Use automatic migration in RepoFlow for new migrations when possible.

The legacy CLI migration flow supports these package types from Nexus 3:

  • npm
  • PyPI
  • Maven (maven2)
  • Go
  • Helm

Open legacy RepoFlow CLI migration docs

Need help with another package type or a complex repository layout? Contact us or email hello@repoflow.io.

Why migrate to RepoFlow

RepoFlow gives you one platform for package types, proxy caching, and flexible cloud or self-hosted deployment, with more details on the features page

Migration steps

  1. Audit repositories and endpoints: Inventory hosted, proxy, and group repositories, then map them to the teams and CI pipelines that use them.
  2. Design the target layout in RepoFlow: Create local, remote, and virtual repositories that match your intended structure and decide how clients should consume them.
  3. Dry run a representative repo: Migrate a smaller repo first using automatic migration in RepoFlow, then validate with a clean build in CI. Existing CLI workflows can continue using the legacy tool.
  4. Plan the cutover window: Choose a short window to freeze publishing during the final sync, and communicate the timing to teams.
  5. Cut over and validate: Run the final sync, update CI and developer endpoints, then run your validation pipelines.
  6. Monitor and decommission: Keep Nexus read only while you watch for missing package and auth issues, then retire it safely.

Want help planning your migration? Email hello@repoflow.io.

Join our mailing list

Product updates, new tools, and practical guides from RepoFlow.