> ## Documentation Index
> Fetch the complete documentation index at: https://gcore.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage container image registries

The **Registries** page in the Gcore Customer Portal lists all container image registries added to the project. Each registry stores the credentials Gcore uses to pull private container images when starting deployment pods. Navigate to **Everywhere Inference > Registries** to open the list.

The registry table has two columns: **Image registry name** and **Image registry url**. The URL identifies the registry host, and the name is the label shown in the deployment form when selecting a registry.

<Frame>
  <img src="https://mintcdn.com/gcore/yKie2I_xdaIxD6qJ/images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-1.png?fit=max&auto=format&n=yKie2I_xdaIxD6qJ&q=85&s=8a2dd80bbc950882d677aaa46793fc7d" alt="Registries list" width="1263" height="573" data-path="images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-1.png" />
</Frame>

## Registry in a deployment

Registries are referenced when [deploying a custom container image](/edge-ai/everywhere-inference/ai-models/deploy-a-custom-model) from a private source. In the **Deploy custom model** form, set **Registry type** to **Private** — a **Registry** dropdown appears showing all registries added to the project. Select the registry that hosts the image, then enter the full image URL in the **Model image URL** field.

<Frame>
  <img src="https://mintcdn.com/gcore/yKie2I_xdaIxD6qJ/images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-4.png?fit=max&auto=format&n=yKie2I_xdaIxD6qJ&q=85&s=a74eb5b634de61aa0796a65801864fa9" alt="Deploy custom model form with Private registry type selected and Registry dropdown showing docs-test-registry" width="1400" height="900" data-path="images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-4.png" />
</Frame>

Gcore uses the stored credentials to authenticate against the registry host and pull the image when the pod starts. The credentials are not embedded in the deployment — they are resolved at pod startup from the registry record.

<Frame>
  <img src="https://mintcdn.com/gcore/yKie2I_xdaIxD6qJ/images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-5.png?fit=max&auto=format&n=yKie2I_xdaIxD6qJ&q=85&s=561b5c5dc7fdfc08020022902c401f15" alt="Registry dropdown open showing the available registry" width="1400" height="900" data-path="images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-5.png" />
</Frame>

## Registry credentials

Only authentication credentials can be updated on an existing registry. The registry name and URL are immutable — to use a different registry host, delete the registry and [add a new one](/edge-ai/everywhere-inference/container-image-registries/add-a-registry).

To open the action menu, click the three-dot button on the right side of the registry row and select **Edit**.

<Frame>
  <img src="https://mintcdn.com/gcore/yKie2I_xdaIxD6qJ/images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-2.png?fit=max&auto=format&n=yKie2I_xdaIxD6qJ&q=85&s=64bfc6f6c7f26aee20221b8ef9c2f268" alt="Registry action menu with Edit and Delete options" width="865" height="347" data-path="images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-2.png" />
</Frame>

The **Edit registry** dialog opens. Enter the updated **Username** and **Password** and click **Save**. The new credentials take effect on the next pod pull — running pods are not affected until they restart.

<Frame>
  <img src="https://mintcdn.com/gcore/yKie2I_xdaIxD6qJ/images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-3.png?fit=max&auto=format&n=yKie2I_xdaIxD6qJ&q=85&s=712920f6dab63076067b3a578461cd31" alt="Edit registry dialog with Username and Password fields" width="1400" height="900" data-path="images/docs/edge-ai/everywhere-inference/container-image-registries/manage-registries/manage-registries-3.png" />
</Frame>

## Registry deletion

Deleting a registry removes the stored credentials from the project. Running deployments that already pulled the image continue operating. New pods — including autoscaled pods and pod restarts — will fail to pull the image until the registry is re-added with valid credentials.

To delete a registry, click the three-dot button on the right side of the row and select **Delete**. Confirm the deletion in the dialog that appears.
