Create an artifact registry

Learn how to create artifact registries, including upstream proxies.

An Artifact Registry is a central location for storing and managing software artifacts, such as container images or Helm charts used throughout the software development lifecycle.

REGISTRY SCOPE LEVELS

Artifact registries can be created at the Account, Organization, or Project level. Navigate to the desired scope in Harness before you create the registry.

To create an artifact registry, follow these steps:

1. Navigate to the Account, Organization, or Project scope where you want to create the registry.

2. Select + New Artifact Registry under the Registries tab.

3. Select a registry type.

4. Enter a Registry Name. Optionally, enter a Description and Labels.

   This registry name must start with a letter and can only contain lowercase alphanumerics, _, . and -

5. Select Private or Public visibility. This setting determines registry access.

   Public registries allow anyone to view repository contents and pull images. Private registries restrict both visibility and image pulls to users or service accounts with the required permissions or tokens.

   FEATURE FLAG REQUIREMENT

   Public registry visibility is gated by the PL_ALLOW_TO_SET_PUBLIC_ACCESS feature flag. The same flag controls both creating a new public registry and switching an existing registry's visibility from Private to Public. If the Public option is missing on the Create Registry form (or on the visibility control of an existing registry), the flag is not enabled for your account.

   To enable public registry visibility:

   1. Contact Harness Support to activate the PL_ALLOW_TO_SET_PUBLIC_ACCESS feature flag for your account.

   2. In your Harness account, go to Account Settings > Authentication and turn on Allow public resources.

   Both steps are required. Go to Change registry visibility to switch an existing registry between Private and Public after the flag is enabled.

6. Select Create Registry.

Create Registry form

Next steps: To know about creating an upstream proxy, go to Create an upstream proxy.