# Create a Container Registry

{% hint style="info" %}
**Prerequisites:** Make sure you have the appropriate permissions. Only contract administrators, owners, and users with the **Manage Registry** permission can create a Container Registry.
{% endhint %}

## Create a Container Registry

1\. In the DCD, go to **Menu** > **Containers** > **Container Registry**.

![Access the Container Registry Manager](/files/i6RSEJmWxCxUlGT9f5XZ)

2\. In the **Container Registry Manager**, click **Add a Registry** to start creating a new container registry.

![Create a new Container Registry](/files/7yI3WkZwF9QqBTUy87IU)

3\. Provide an appropriate **Name**.

{% hint style="info" %}
**Note:** It is not possible to change the registry **name** later. The registry **name**:

* must be globally unique across all customers.
* must contain only alphanumeric characters and dashes.
* must be between 3 and 63 characters in length.
* must begin with an character between a-z.
* must end with an alphanumeric character.
  {% endhint %}

4\. Choose the **Location** where you want your container registry to be run and the artifacts to be stored from the drop-down list.

{% hint style="info" %}
**Note:** It is not possible to change the **Location** later.
{% endhint %}

5\. Turn on the **Vulnerability Scanning** toggle so that your Container Registry is created with the vulnerability scanning enabled.

{% hint style="info" %}
**Note:** We recommend that you create your Container Registry with **Vulnerability Scanning** enabled.

**Vulnerability Scanning** gives you the benefit of all artifacts being scanned for CVEs when pushed into a Container Registry and every time CVE databases are updated with newly identified CVEs. It is possible to add Vulnerability Scanning to a Container Registry. Once Vulnerability Scanning is enabled, it cannot be disabled later.
{% endhint %}

6\. Click **Add Registry**. Your Container Registry and storage will be created.

![Enter the values for creating a Container Registry](/files/ITFhpDXtN0UQAPke6Oy6)

{% hint style="success" %}
**Result:** Your Container Registry is ready to use when its status is updated to **Running**.
{% endhint %}

![The Container Registry is ready to use](/files/F7zspezmi7X1BzTxTYYi)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/containers/private-container-registry/dcd-how-tos/create-container-registry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.