> 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/deployment/how-to-create-a-dedicated-deployment-in-acecloud.md).

# How to Create a Dedicated Deployment in AceCloud?

### **Overview**

A **Dedicated Deployment** in AceCloud allows you to run applications on **exclusive infrastructure resources** allocated specifically to your project.

This option provides:

* Better performance
* Resource isolation
* Ability to access deployments privately within your VPC

### **Prerequisites**

Before creating a deployment, ensure:

* You are logged in to the AceCloud portal
* A **Project** and **Region** are selected
* You have a valid **container image** (Public or Private)
* A **VPC network** is available

***Note**: Ensure that the VPC has an active router configured. VPCs provisioned via firewall configurations are not eligible for selection.*

### **Step 1: Navigate to Deployment Creation**

1. Go to **Deployments** from the left menu, then click **Overview**

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/pVnoRUKOdwbLMja9r4Hb/Unknown%20image)

2. Click **Create Deployment**

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/kwEy7KPWoTOgy2rEFFNO/Unknown%20image)

### **Step 2: Configure Deployment Details**

#### **2.1 Deployment Name**

* Enter a unique name
* Example: my-app

#### **2.2 Deployment Type**

* Select **Dedicated**

### **Step 3: Select Image Type**

#### **Option A: Public Image**

#### **3A.1 Select Public Image**

* Choose **Public Image**

#### **3A.2 Image URL / Tag**

* Enter image URL

**Examples:**

nginx

#### **3A.3 Command (Optional)**

* Override the default container command if required

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/I1P3qYLTYpIR5hJYD7bv/Unknown%20image)

#### **Option B: Private Image**

#### **3B.1 Select Private Image**

* Choose **Private Image**

***Note:** Support for **Private Images*** in ***Dedicated Deployments*** is currently under development and will be available in an upcoming release.

#### **3B.2 Registry Secret**

* Select an existing **Registry Secret**

**OR**

* Click **Create new registry secret**
* Add registry credentials
* Save and select the secret

***Note:*** If registry credentials are regenerated using **Generate Credentials**, the previously saved credentials are invalidated. Ensure that you update the **Registry Secret** and restart your deployment.

#### **3B.3 Image URL / Tag**

* Enter the full image name and tag

**Example:**

*myapp:latest*

*ubuntu:latest*

***Note:*** *The registry URL is automatically prefixed. You only need to enter the image in the format image:tag.* 

*Only images hosted in the AceCloud registry are supported. To use images from other private registries, first migrate them to the AceCloud registry using **ACR Source Registry + Replication**.*

#### **3B.4 Command (Optional)**

* Enter a custom startup command if required. If not specified, the default command defined in the container image will be used.

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/lDNkxusPLVDgfZMnO3v8/Unknown%20image)

### **Step 4: Configure Resources**

#### **4.1 Resource Flavor**

* Select a predefined resource configuration

#### **4.2 Replicas**

* Define the number of instances

#### **4.3 Autoscaling (Optional)**

Enable autoscaling to automatically scale based on usage.

If enabled, configure:

* **Minimum Replicas**
* **Maximum Replicas**
* **CPU Target (%)**
* **Memory Target (%)**

### **Step 5: Configure Networking**

#### **5.1 Network Configuration**

* Choose a **VPC** from the dropdown

Deployment will run inside the selected VPC.

***Note:***

* *The selected VPC must have a router configured and must not be a firewall-created VPC.*
* *If you do not have an existing VPC, select **Create VPC** to create a new VPC for the deployment.*

### **Step 6: External Access**

#### **6.1 Enable External Access**

* Toggle ON to make the application accessible externally

#### **6.2 Endpoint Access Type**

**Public**

* Accessible from anywhere

**Protected**

* Restricted access

When selected:

* You must provide **Allowed IP CIDR(s)**

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/Bxe4CZB0AFkZrsLASURn/Unknown%20image)

#### **6.3 Allowed IP CIDR(s)**

* Define allowed IP ranges

**Example:**

192.168.1.0/24

10.0.0.0/16

#### **6.4 Ports Configuration**

Click **Add Port** and configure:

* **Name** → Port name
* **Protocol** → HTTP / HTTPS / TCP / UDP
* **Exposed Port** → Client-facing port of the deployment; can be public or private depending on External Access
* **Container Port** → Internal container port

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/DjDn6kJG5GO7WwHlVCzQ/Unknown%20image)

### **Step 7: Configure Volumes (Optional)**

* Click **Add Volume**
* Attach persistent storage

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/TuMJ05McG6rIcTQGjJQS/Unknown%20image)

### **Step 8: Configure Environment Variables**

#### **8.1 Environment Secrets**

* Select an existing secret OR
* Click **Create new secret**

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/ypQqJtnfde3ZMea24KZZ/Unknown%20image)

#### **8.2 Environment Variables**

Click **Add Environment Variables**

* Add key-value pairs

**Example:**

NODE=production

PORT=3000

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/dKgdWN3TDg2Pp9Ln5p5H/Unknown%20image)

### **Step 9: Review Deployment Summary**

Verify on the right panel:

* Deployment Type → Dedicated
* Image Type
* Resource Flavor
* Replicas & Autoscaling
* Network configuration
* External access
* Ports

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/WOqhzeCNFRDmoN3RWsgX/Unknown%20image)

### **Step 10: Create Deployment**

* Click **Create Deployment**

![](https://content.gitbook.com/content/TggNIL2XCTGYjqxjawZl/blobs/1mj3gcA9PwCr2mHp7YG3/Unknown%20image)

The platform will:

* Provision dedicated resources
* Pull image and start container(s)
* Apply scaling and access settings

### **Post Deployment**

After successful deployment:

* Access via endpoint
* Monitor under **Insights**
* Scale or update anytime
* If the deployment remains in the **Provisioning** state for an extended period, open the deployment and review the container logs to identify any errors or issues preventing the deployment from becoming active.
* Dedicated deployments may take approximately **20–30 minutes** to become active, as dedicated infrastructure resources are provisioned within your project during the deployment process.