Create an OCI Repository

Create an OCI Repository

Create an OCI repository to pull, publish, or aggregate container images and OCI artifacts. See Repository Management and Repository Types for more details.

Note
OCI repository names must be lowercase.

OCI Proxy Repository

Use Nexus proxy repository when you want to download packages and centralize package caching of external dependencies. To learn more, check Proxy Repositories.

To create an OCI proxy repository, complete the following steps:

  1. Go to Settings → Repository → Repositories.
  2. Select Create repository button.
  3. From the list of recipes, select oci (proxy).
  4. In the form that appears, complete the required fields.
    • Repository Name, for example docker-proxy-oci
    • Remote storage URL, for example https://registry-1.docker.io.
      If the upstream registry requires credentials, enter the username and password.
    • Blob store
  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
  6. Select Create repository.

OCI Hosted Repository

Use Nexus hosted repository when you want to publish and store your own internal artifacts and third party components, so they can be consumed via Nexus. To learn more, check Hosted Repositories.

To create an OCI hosted repository, complete the following steps:

  1. Go to Settings → Repository → Repositories.
  2. Select Create repository button.
  3. From the list of recipes, select oci (hosted).
  4. In the form that appears, complete the required fields.
    • Repository Name, for example docker-hosted-oci
    • Blob store
  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
  6. Select Create repository.

Tip
To enforce tag immutability, set the deployment policy to Disable redeploy so an existing tag cannot be overwritten with different content.

OCI Group Repository

Use Nexus group repository when you want to combine multiple other repositories (proxy, hosted, and other groups) and expose them through a single URL. To learn more, check Group Repositories.

To create an OCI group repository, complete the following steps:

  1. Go to Settings → Repository → Repositories.
  2. Select Create repository button.
  3. From the list of recipes, select oci (group).
  4. In the form that appears, complete the required fields.
    • Repository Name, for example docker-group-oci
    • Blob store
    • Member repositories in the desired order.
  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.
  6. Select Create repository.

Note
When the same image path exists in more than one member repository, the group serves the image from the first member in the configured order.