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

![](https://content.gitbook.com/content/6xzVdxzgFAXWb0qJY9hx/blobs/N27XCLTNabkIp4oaoP4I/Unknown%20image)

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

![](https://content.gitbook.com/content/6xzVdxzgFAXWb0qJY9hx/blobs/M8aIM0TDletYnpTJxU3a/Unknown%20image)

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

![](https://content.gitbook.com/content/6xzVdxzgFAXWb0qJY9hx/blobs/1irS9HTznAWhTO8wDBBc/Unknown%20image)

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.

![](https://content.gitbook.com/content/6xzVdxzgFAXWb0qJY9hx/blobs/2ceWqj3Ce4kubZMOD67o/Unknown%20image)

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

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

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

![](https://content.gitbook.com/content/6xzVdxzgFAXWb0qJY9hx/blobs/Jwm1LFWtofA3mdpXFTNH/Unknown%20image)

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