> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/registry/how-to-create-a-registry.md).

# 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**.

<figure><img src="/files/dRUjSMqVS5jARCnuVgHS" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/53xyDJEHKVDmlhcHPLl2" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/98YbutkMXyB28vzRjE4L" alt=""><figcaption></figcaption></figure>

📝 *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.

<figure><img src="/files/OyrgKaVIJOhHg4PUoXtq" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/x9jXSa6kmmDYJBg5zN4x" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/CGl5D9RnJqNlb7iLq0XE" alt=""><figcaption></figcaption></figure>

* 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**