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

# Agency - White Label - Configuring Custom Domain

The feature of **Custom Domain** allows you to use your own domain in instances created by the agency.

With this configuration, new instances will start using a custom address in the format:

`instancename.yourdomain.com.br`

The certificate **SSL is automatically issued by Cloudflare**.

***

### Accessing the settings

In the agency dashboard, go to:

**Menu → Agency Information → White Label → Frontend Domain**

On this screen, it will be possible to configure the custom domain and track the instance domains.

<figure><img src="/files/4edc6328eefa338c3eb44ed6dcf2dfa0e8e958a8" alt=""><figcaption></figcaption></figure>

***

> **Important:** If no domain is configured, new instances will be created on the platform's default domain, in the format `instancename.sprinthub.app`.

***

### Configuring the custom domain

Domain configuration is done in two steps.

***

#### 1. Create a CNAME record in your DNS

In your DNS provider's dashboard, such as **OVH, Registro.br, GoDaddy, Cloudflare**, among others, create a record of the type **CNAME**.

Use the following information:

| Type  | Name (Host) | Value (Destination)             |
| ----- | ----------- | ------------------------------- |
| CNAME | `*`         | `sprinthub-front-ovh.pages.dev` |

The character `*` represents a **wildcard**. This way, the instances' subdomains can be routed automatically without the need to create an individual record for each one.

***

#### Example

When configuring the wildcard `*.yourdomain.com.br` pointing to `sprinthub-front-ovh.pages.dev`, an instance called `postobrasil` can be accessed at:

`https://postobrasil.yourdomain.com.br`

***

#### 2. Enter the base domain

After creating the CNAME record, return to the screen **White Label → Frontend Domain**.

In the field **Base Domain**, enter only the domain that will be used.

For example:

`yourdomain.com.br`

> **Attention:** enter only the domain, **without `https://` and without `*`**.

Then, click **Save and activate**.

After saving, the option **Check DNS** will be available to verify the configuration.

***

### Instance domains

In the section **Instance domains**, the hosts created automatically in Cloudflare will be displayed when an instance is registered with the feature enabled.

These domains are also registered in the central dashboard and appear in the **instance's own White Label**.

***

If there is still no instance provisioned with the feature enabled, a message will be displayed informing that no domain has been provisioned.

***

### Configuration summary

To use the custom domain:

1. Access **Agency Information → White Label → Frontend Domain**.
2. Create a record **CNAME** in your DNS provider.
3. Configure the host `*`.
4. Point the CNAME to `sprinthub-front-ovh.pages.dev`.
5. Enter the **base domain**, without `https://` and without `*`.
6. Click **Save and activate**.
7. Use **Check DNS** to validate the configuration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.sprinthub.com/en/white-label/agency/common-questions/agency-white-label-configuring-custom-domain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.