# Cloud DNS Zone

The DuploCloud Platform requires a unique GCP Cloud DNS zone to create DNS entries for the services you deploy. The domain must be registered with a domain provider and set in DuploCloud before configuration. We recommend creating a subdomain such as `apps.[MY-COMPANY].com` or `internal.[my-company].com`.

For more info about DNS setup and custom DNS names, see the [DNS Configuration documentation](https://docs.duplocloud.com/docs/automation-platform/duplocloud-prerequisites/resolving-dns-failures). 

{% hint style="danger" %}
Never use this subdomain for any other purpose, as DuploCloud owns all CNAME entries in this domain and will remove any entries it does not manage.
{% endhint %}

## Creating a DNS Zone

Create a DNS Zone in the GCP Console:

1. Log in to the [GCP console](http://console.cloud.google.com/).
2. Select **Network Services** -> **Cloud DNS**.  
3. Click **Create Zone**, as shown below, and note the Zone Name you create. You will need it to add to DuploCloud in a later step.  
4. Access the zone and note the Nameserver names.

## Configuring NS Records

1. Navigate to your root Domain Provider's site (for `acme.com`, for example).
2. Create an NS record that references the domain name of the hosted zone you created (`apps.acme.com`), and add the zone name to the Nameservers you noted above.

<div align="left"><figure><img src="https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FhetD1sYtxCMwB6u0FHRQ%2FGCP-DNS1.png?alt=media&#x26;token=7910f2cf-47d7-491d-8e8f-72f7d1a2503e" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FxvVDDynoyHK5tT8KcbYL%2FGCP-DNS2.png?alt=media&#x26;token=83233d22-f6b3-4532-bbdc-7fe7e85d1f75" alt=""><figcaption></figcaption></figure></div>

## Provisioning the Zone in DuploCloud

Provision the zone in every DuploCloud Plan, starting with the Plan created in the previous step.

1. In the DuploCloud Portal, navigate to **Administrator** -> **Plans**.&#x20;
2. Select the Plan name from the **NAME** column.&#x20;
3. Select the **DNS** tab, and click **Edit**. The **Set Plan DNS** pane displays.
4. In the **Cloud DNS Zon**e field, enter the zone name.
5. In the **External DNS Suffix** and **Internal DNS Suffix** fields, enter the domain name, preceded with a dot (**.**)
6. Click **Submit**.&#x20;

{% hint style="warning" %}
Do not forget the dot (**.**) at the beginning of the DNS suffix, in the form as shown below.
{% endhint %}

<div align="left"><figure><img src="https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FxNVVXsBVOptJAtpWW1H1%2Fimage.png?alt=media&#x26;token=1b283f22-ff15-42a4-a643-5435b99fbdce" alt=""><figcaption><p>The <strong>Set Plan DNS</strong> pane</p></figcaption></figure></div>

{% hint style="info" %}
Note that this domain must be set in each new Plan you create in your DuploCloud Infrastructure.
{% endhint %}