> 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**.
### **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**.
📝 *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.
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.
* This feature scans images for known security vulnerabilities when pushed.
### **6. Click on Create Registry**
* Review your settings and click **Create Registry**.
* 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**
