# 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](/docs/automation-platform/duplocloud-prerequisites/resolving-dns-failures.md).

{% 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="/files/OZfWbJ6IwXBBoxe0ZiFp" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/OYqR6wlCVIbhvSqm9ulv" 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**.
2. Select the Plan name from the **NAME** column.
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**.

{% 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="/files/nFzR9KULh0f4P5KUMBm2" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.duplocloud.com/docs/automation-platform/overview-1/prerequisites/route-53-hosted-zone.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.