# How to create a registry?

This article explains how to create a container registry in AceCloud. Each project can have only one registry per region. Creating a registry is the first step in securely managing and distributing container images across your environments.

## **Steps to Create a Registry**

### **1. Navigate to Container Registry**

* Log in to the [AceCloud](https://customer.acecloudhosting.com/) Console.
* From the left-hand menu, go to **Registry** under your desired **Project** and **Region** and click **Overview**.

![](/files/5d6f1923303a0bf2c61b6a5fc0b8d3593b751013)

### **2. On the Container Registry page, click the Get Started button.**

### **3. Enter Registry Name**

* In the *Create Registry* form, provide a unique **Registry Name**.

![](/files/e9f46ab9f730661a79a12a9f4e19f24a1997980b)

📝 *Note: This name will also be used as the destination namespace for replication. Keep it consistent.*

### **4. Configure Immutable Rule (Optional)**

* Enable the **Immutable Rule** to prevent tags from being overwritten.

![](/files/ff2f68e8d0b7056557caf80d667909dd17f74911)

Configure the following:

* **Repository Matching**: Specify repository names or patterns.
  * Use \* to match multiple repositories at the same level.
  * Use \*\* to match repositories across multiple levels.
* **Tag Matching / Excluding**: Define tag patterns (e.g., v1.\*, latest).
  * Use \* to match any sequence of characters in the tag.
  * Use \*\* for recursive matching across paths.

### **5. Enable Vulnerability Scanning (Optional)**

* Toggle the **Enable Vulnerability Scanning** checkbox.

![](/files/d03ad191cb23df39fd02a8816594d05316bd3a3d)

* This feature scans images for known security vulnerabilities when pushed.

### **6. Click on Create Registry**

* Review your settings and click **Create Registry**.

![](/files/74b1eae1e9fd5a71120466573bd1741052a9f8c8)

* The registry will be created and listed under the **Container Registry** section.

## **Important Notes**

* You can only have **one registry per project per region**.
* **Immutable tags** help avoid accidental overwrites.
* **Vulnerability scanning** improves image security by identifying threats early.
* **Destination namespace** (used during replication) should match the **registry name**


---

# 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.acecloud.ai/knowledge-base/registry/how-to-create-a-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.