Create an OCI Repository

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

This topic describes how to create an OCI repository. This is required before publishing and installing OCI images and other OCI-compliant artifacts. There are three primary types of repositories:

  • Local repositories: Store and share first- and second-party packages with your organization

  • Remote repositories: Download packages from remote OCI-compliant registries or other Artifactory instances

    DockerHub Remote Repository Restrictions

    Artifactory provides unlimited access to the DockerHub remote repository for unauthenticated Cloud users. Excessive use may incur a rate limit of 100 pulls per six hours. For compliance and security, and to avoid rate limits, authenticate to DockerHub using credentials.

  • Virtual repositories: Aggregate remote and local repositories, enabling your organization to scale by providing a single URL that provides access to multiple repositories and types

For more information on JFrog repositories, see Repository Management Overview.

Supported Naming Conventions

Due to OCI client limitations, do not use underscores (_) or uppercase letters in OCI repository names. The OCI client cannot communicate with a repository named oci_local or OCI-local, but it can communicate with oci-local .

Prerequisite: You need Admin or Project Admin permissions in Artifactory to create a repository. If you don't have Admin permissions, the option will not be available.

To create an OCI repository:

  1. In the Administration tab, click Repositories | Create a Repository.

    CreateAnsibleLocal1.png

  2. Select the type of repository you want to create: local, remote, or virtual.

  3. Select the OCI package type.

  4. Configure the required fields for the repository:

    • For local repositories, in the Repository Key field, type a meaningful name for the repository. For example, oci-local. For more information on local repositories and their settings, see Local Repositories.

    • For remote repositories, verify the Repository URL and update as needed. For more information on remote repositories and their settings, see Remote Repositories.

    • For virtual repositories, select one or more local or remote repository types to include in the virtual repository. For more information on virtual repositories and their settings, see Virtual Repositories.

  5. Click Create Repository. The repository is created and the Repositories window is displayed.