Import repositories from Nexus
Current import workflow for bringing selected repositories from Sonatype Nexus into Craftifact.
Scope and prerequisites
- Current source support is Sonatype Nexus only.
- Import is available for paid Pro and above, plus approved demos.
- The target Craftifact instance must already be provisioned and ready.
- Nexus authentication is currently basic auth only.
Current importable package formats are:
- Maven
- Python
- OCI
- npm
- Nexus Raw Hosted to Generic
If you need another source system, contact support.
Workflow
- Open the instance detail page and go to Import.
- Enter the Nexus base URL, username, and password.
- Click Fetch repositories.
- Review which repositories are importable and which are blocked.
- Optionally run Determine size before starting.
- Start the import and monitor per-repository progress.
Credentials are stored encrypted, reused for up to 1 hour of inactivity, and never shown back to the browser.
Selection rules
- Unsupported formats are disabled.
- Nexus Raw Proxy and Group repositories are not importable. Raw Hosted requires a target Craftifact version that advertises the capability; older targets keep Raw disabled without affecting the established formats.
- If a repository name already exists in Craftifact, delete or rename it first.
- Group repositories can only be imported when all member repositories exist in Nexus and are selected together.
- Proxy repositories can be imported, but cached proxy content is not imported.
Runtime behavior
- Imports run as background jobs and can take a long time.
- Only one import can run per instance at a time.
- Progress is tracked per repository, not per byte.
- Failed repositories expose per-repository logs.
Cancellets the current repository finish and skips the rest.Force closeis available if a cancelling import gets stuck.Retryrequeues failed, skipped, or still-pending repositories from the latest run.
Hosted content is streamed directly into guarded Craftifact storage; complete files are not buffered in temporary storage. One hard repository deadline covers discovery, pagination, retries, downloads, storage writes, checksum validation, and publication. Authenticated requests and redirects cannot leave the explicitly configured Nexus or OCI registry origin.
The instance configuration accepts these optional limits (shown with their defaults):
nexus_import:
max_object_size: 10GiB
max_inflight_size: 40GiB
Quota behavior
If the known selection size is already above the currently available quota, the import is blocked before it starts. Unknown repository sizes are allowed with warning, so large imports can still fail later when quota is reached.
The object limit applies to every imported object. Inflight capacity is shared across all simultaneous Nexus imports and formats. Repository quota remains an additional limit. Generic imports also apply the Generic repository and global limits, so the strictest applicable limit wins; bytes are not charged twice to storage quota. Every object reserves capacity and quota while streaming. Failed, cancelled, oversized, or checksum-invalid objects remain invisible and partial storage is removed.
What to do after a successful import
Imported repositories are created in Craftifact, but new repositories are left inactive until you add them to the instance configuration.
Use the Cleanup tab to copy the generated restore snippet, add that snippet to Effective configuration, and deploy the config.
Authorization is also separate:
- repository permissions are not imported from Nexus
- role and group setup must be adjusted manually in config