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

# Connecting a Private Container Registry

> Connect a private Docker registry to your Vault so private images can be used in your tools.

<Warning>
  Private container registry integration is available exclusively for [Enterprise](https://trickest.com/pricing/) users. To learn more, [contact us](https://trickest.com/talk-with-us/).
</Warning>

## Overview

Connecting a private container registry lets the platform pull Docker images from it when running private tools. Once connected, images from that registry can be referenced in your [private tool configurations](./adding-private-tools) without any extra authentication steps.

## Obtaining Credentials

Before connecting a registry, you will need a username and an access token or password. The exact steps depend on your provider:

* [Docker Hub](https://docs.docker.com/security/for-developers/access-tokens/)
* [GitHub Packages](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry)
* [AWS ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html#registry-auth-token)

For any other registry that supports the Docker Registry HTTP API, use the username and password or token that grants read access to the relevant images.

## Adding a Registry

<Steps>
  <Step title="Navigate to Container Registry settings">
    Go to **Settings > Infrastructure > Container Registry**.
  </Step>

  <Step title="Open the Add registry menu">
    Click **Add registry** in the top-right of the page. A dropdown opens listing the supported registry types: **Docker Registry**, **Docker Hub**, and **GitHub**.
  </Step>

  <Step title="Choose a registry type">
    Select the type that matches your provider. The form for that type opens. See the field reference below for what each type requires.
  </Step>

  <Step title="Fill in the connection details">
    Enter the required fields, then click **Add registry** at the bottom of the form to save the new registry. When editing an existing registry the same button reads **Save changes**.
  </Step>
</Steps>

### Docker Registry

Use this for any self-hosted registry or a registry that supports the Docker Registry HTTP API (including AWS ECR).

| Field                | Description                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Name**             | Display name for this registry within the platform.                                                                |
| **Registry URL**     | Full URL of the registry, including any namespace (e.g., `aws_account_id.dkr.ecr.region.amazonaws.com/namespace`). |
| **Username**         | Registry username.                                                                                                 |
| **Password / Token** | Registry password or access token.                                                                                 |

### Docker Hub

| Field                   | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| **Name**                | Display name for this registry within the platform.                |
| **Docker Hub Username** | Your Docker Hub username.                                          |
| **Access Token**        | A Docker Hub access token with read access to the relevant images. |

### GitHub

| Field                     | Description                                                    |
| ------------------------- | -------------------------------------------------------------- |
| **Name**                  | Display name for this registry within the platform.            |
| **GitHub Username**       | Your GitHub username.                                          |
| **Personal Access Token** | A GitHub personal access token with the `read:packages` scope. |

## Managing Connected Registries

All connected registries are listed on the **Container Registry** page. Click an entry to open its details panel; the **`...`** menu in the panel header offers **Rename** and **Delete**. Deleting a registry will prevent the platform from pulling images that depend on it.