> 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/white-label/agencia/duvidas-comuns/agencia-white-label-configurando-dominio-customizado.md).

# Agência - White Label - Configurando Domínio Customizado

O recurso de **Domínio Customizado** permite utilizar um domínio próprio nas instâncias criadas pela agência.

Com essa configuração, as novas instâncias passam a utilizar um endereço personalizado no formato:

`nomedainstancia.seudominio.com.br`

O certificado **SSL é emitido automaticamente pelo Cloudflare**.

***

### Acessando a configuração

No painel da agência, acesse:

**Menu → Informações da agência → White Label → Domínio frontend**

Nessa tela, será possível configurar o domínio personalizado e acompanhar os domínios das instâncias.

<figure><img src="/files/IrJIWvVqA8bxGoqlfrPk" alt=""><figcaption></figcaption></figure>

***

> **Importante:** Caso nenhum domínio esteja configurado, as novas instâncias serão criadas no domínio padrão da plataforma, no formato `nomeinstancia.sprinthub.app`.

***

### Configurando o domínio customizado

A configuração do domínio é realizada em duas etapas.

***

#### 1. Crie um registro CNAME no seu DNS

No painel do seu provedor de DNS, como **OVH, Registro.br, GoDaddy, Cloudflare**, entre outros, crie um registro do tipo **CNAME**.

Utilize as seguintes informações:

| Tipo  | Nome (Host) | Valor (Destino)                 |
| ----- | ----------- | ------------------------------- |
| CNAME | `*`         | `sprinthub-front-ovh.pages.dev` |

O caractere `*` representa um **curinga (wildcard)**. Dessa forma, os subdomínios das instâncias poderão ser direcionados automaticamente sem a necessidade de criar um registro individual para cada uma.

***

#### Exemplo

Ao configurar o curinga `*.seudominio.com.br` apontando para `sprinthub-front-ovh.pages.dev`, uma instância chamada `postobrasil` poderá ser acessada em:

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

***

#### 2. Informe o domínio base

Após criar o registro CNAME, retorne à tela **White Label → Domínio frontend**.

No campo **Domínio base**, informe somente o domínio que será utilizado.

Por exemplo:

`seudominio.com.br`

> **Atenção:** informe apenas o domínio, **sem `https://` e sem `*`**.

Em seguida, clique em **Salvar e ativar**.

Após salvar, a opção **Verificar DNS** ficará disponível para realizar a verificação da configuração.

***

### Domínios das instâncias

Na seção **Domínios das instâncias**, serão exibidos os hosts criados automaticamente no Cloudflare quando uma instância for cadastrada com o recurso ativo.

Esses domínios também ficam registrados na central e aparecem no **White Label da própria instância**.

***

Caso ainda não exista nenhuma instância provisionada com o recurso ativo, será exibida a mensagem informando que nenhum domínio foi provisionado.

***

### Resumo da configuração

Para utilizar o domínio customizado:

1. Acesse **Informações da agência → White Label → Domínio frontend**.
2. Crie um registro **CNAME** no seu provedor de DNS.
3. Configure o host `*`.
4. Aponte o CNAME para `sprinthub-front-ovh.pages.dev`.
5. Informe o **domínio base**, sem `https://` e sem `*`.
6. Clique em **Salvar e ativar**.
7. Utilize **Verificar DNS** para validar a configuração.


---

# 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/white-label/agencia/duvidas-comuns/agencia-white-label-configurando-dominio-customizado.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.
