> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/en/platform-features/custom-domain.md).

# Custom Domain

Configure your domain for your Discloud hosted application.

## 🧭 Overview

You can map your own domain (e.g. `yourdomain.com`) or a subdomain (e.g. `dash.yourdomain.com`) to an application hosted on Discloud. The platform serves traffic through your app's [Discloud subdomain](https://docs.discloud.com/en/faq/general-questions/how-to-create-a-subdomain.md) using two A records pointing to our IPv4 addresses.

<figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2FEJatnuPlgieWMNo9FOyI%2Fcustom-domain-flow.png?alt=media&amp;token=59e8307c-9a35-49cc-ae59-3d06c79f0783" alt="Custom domain flow diagram"><figcaption></figcaption></figure>

***

## 📋 Requirements

{% hint style="success" %}
[Diamond plan or higher](https://discloud.com/plans) is required to host websites or APIs.
{% endhint %}

{% hint style="success" %}
[App already hosted](https://docs.discloud.com/en/getting-started/websites-and-apis.md) using a Discloud subdomain (e.g. `example.discloud.app`)
{% endhint %}

{% hint style="success" %}
A registered domain you control (Cloudflare, Hostinger, GoDaddy, Namecheap, etc.)
{% endhint %}

{% hint style="success" %}
Ability to add / modify A records
{% endhint %}

***

## 🏗️ Add Your Domain (Dashboard)

{% stepper %}
{% step %}
Open the [Discloud Dashboard](https://discloud.com/dashboard) → [`Domains`](https://discloud.com/dashboard/domains) section.
{% endstep %}

{% step %}
Click **+ Add domain** and enter your domain (e.g. `yourdomain.com`). Optionally specify a subdomain (e.g. `dash`).
{% endstep %}

{% step %}
Click **See DNS** to view the records you need to configure.
{% endstep %}
{% endstepper %}

<div data-full-width="false"><figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Fgit-blob-6307c2acd7bf24cc39422885b38cb5d1555ab995%2FWebsite-Custom-Domain.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Fgit-blob-10c515311241772a8186083a1c75cb41e635b7b1%2FWebsite-Custom-Domain-DNS-A.png?alt=media" alt="List of A records showing 75.2.96.173 and 99.83.186.151"><figcaption></figcaption></figure></div>

***

## ✅ Configure DNS

Although any DNS provider works, below are tabbed scenarios for clarity.

{% tabs %}
{% tab title="Root Domain" %}
**Records**

| Type         | Name                   | Value           |
| ------------ | ---------------------- | --------------- |
| A            | `@` (or provider root) | `75.2.96.173`   |
| A            | `@` (or provider root) | `99.83.186.151` |
| {% endtab %} |                        |                 |

{% tab title="Subdomain" %}
**Example: `dash.yourdomain.com`**

<table><thead><tr><th width="144">Type</th><th width="353">Name</th><th>Value</th></tr></thead><tbody><tr><td>A</td><td><code>dash</code></td><td><code>75.2.96.173</code></td></tr><tr><td>A</td><td><code>dash</code></td><td><code>99.83.186.151</code></td></tr></tbody></table>

Multiple subdomains (e.g. `api`, `app`) repeat this pattern independently.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}

#### **Cloudflare Proxy**

If you use **Cloudflare**, it is mandatory to disable the **Proxy** (ensure it is set to **DNS Only** / **Grey Cloud**, not the Orange one). This ensures correct SSL certificate issuance.
{% endhint %}

<figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Fgit-blob-1937d5d9929fd39548145870baac9c6b47eb6da9%2FCloudflare-Custom-Domain-DNS.png?alt=media" alt="Cloudflare dashboard showing DNS Only (Grey Cloud) for A records"><figcaption></figcaption></figure>

***

## 🔄 Rebuild the App

After DNS propagates, open the linked app and trigger Rebuild so the binding becomes active.

<div data-full-width="false"><figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Fgit-blob-f8f2dd082cfee097c3e5d24e567f9b017a2a1146%2FWebsite-Applications_Subdomain.png?alt=media" alt="App list showing custom domain"><figcaption></figcaption></figure> <figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Fgit-blob-f716982fa14666664ff1c548ea4005a2a57f26d4%2FWebsite-Applications_Rebuild.png?alt=media" alt=""><figcaption></figcaption></figure></div>

***

### 📡 **DNS Propagation**

* DNS changes typically propagate within a few minutes.
* However, **TTL values** and **resolver cache** may cause some delays.
* To verify changes worldwide, check [dnschecker.org](https://dnschecker.org/)
* If some POPs still display old records, wait and re-check later.

<figure><img src="https://4206165266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETNoAt35DpCBhinHpaRx%2Fuploads%2Frcud0pvMyXdYyWmwNU4Y%2Fdns-check-propagation.png?alt=media&amp;token=f3ee234a-58a7-43be-abb9-5a8e79792fde" alt=""><figcaption></figcaption></figure>

***

## 🛡️ Control traffic with Edge

With the domain active, you can block paths, put the site in maintenance, change headers and create redirects at the Discloud edge, before the request reaches the application.

{% content-ref url="/pages/8sxxlXz7jLpXpf1ju7gh" %}
[Edge](https://docs.discloud.com/en/platform-features/edge.md)
{% endcontent-ref %}
