> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/open-source/use-harness-open-source/registries/overview.md).

# Overview

### Create an artifact registry <a href="#create-an-artifact-registry" id="create-an-artifact-registry"></a>

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. To create one, follow these steps:

1. In your [project](/open-source/use-harness-open-source/administration-1/project-management.md), select **Artifact Registries**, and then select **New Artifact Registry**
2. Select a [registry type](/open-source/use-harness-open-source/registries/whats-supported.md#supported-registry-types).
3. Enter a **Registry Name** and optional **Description** and **Labels**.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This registry name must start with a letter and can only contain lowercase alphanumerics, <code>_</code>, <code>.</code> and <code>-</code></p></div>
4. Select **Create Registry**.

### Create an upstream proxy <a href="#create-an-upstream-proxy" id="create-an-upstream-proxy"></a>

An **Upstream Proxy** for an **Artifact Registry** is a proxy configuration that allows the registry to fetch artifacts from another external or remote registry. When a user requests an artifact that isn't available in the local registry, the registry directs the request to a configured upstream proxy. To create one, follow these steps:

1. In your [project](/open-source/use-harness-open-source/administration-1/project-management.md), select **Artifact Registries**.
2. Select the dropdown next to **New Artifact Registry**, and then select **Upstream Proxy**.
3. Select a [registry type](/open-source/use-harness-open-source/registries/whats-supported.md#supported-registry-types).
4. Enter the **Upstream Proxy Key**. This is the identifier or name for the proxy within Harness Open Source instance and is chosen by you.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This proxy key must start with a letter and can only contain lowercase alphanumerics, <code>_</code>, <code>.</code> and <code>-</code></p></div>
5. Depending on the registry, fill out any other required settings.
6. Choose your **Authentication** method.
7. Select **Create Upstream Proxy**.

### Set an upstream proxy <a href="#set-an-upstream-proxy" id="set-an-upstream-proxy"></a>

After creating an upstream proxy, you can set it in your local artifact registry. To do so, follow these steps:

1. In your registry, select **Configuration**.
2. Open the **Advanced (Optional)** dropdown menu.
3. Select **Configure Upstream**.
4. Under **Available upstream proxies**, you will see a list of available upstream proxies. Select as many as you would like.
5. Under **Selected proxies**, you will see an ordered list of selected proxies for this registry. When the registry receives a request, the proxies will be *queried in order* from top to bottom.

### Registry configuration <a href="#registry-configuration" id="registry-configuration"></a>

To change your registry settings, go to the registry and select **Configuration**."

Here you can:

* Change your registry **Description**.
* Add a label under **Labels**.
* Set an **Upstream Proxy** under **Advanced** settings.

### Delete a registry <a href="#delete-a-registry" id="delete-a-registry"></a>

1. In **Artifact Registries**, select the three dots on the right of the registry you want to delete.
2. Select **Delete**.

OR

1. In your registry, select the three dots on the top right next to **Setup Client**.
2. Select **Delete**.