# Ligar domínio próprio

Você adiciona o domínio ao site, cria os registros DNS que o painel mostra e clica em **Verificar agora**. Quando o estado fica ativo, o HTTPS é emitido automaticamente.

## Antes de começar

- Um site **público**. Sites privados não aceitam domínio.
- Acesso ao painel DNS do seu domínio (registro.br, Cloudflare e similares).
- Papel de **Membro** ou acima no time.
- Um plano que inclua domínios personalizados.

## Passo a passo

1. No menu, abra **Domínios** e clique em **Conectar domínio**. (Também dá para usar a aba **Domínios** na tela do site.)
2. Em **Site**, escolha o site público e, em **Domínio**, digite por exemplo `api.meusite.com.br`, sem `http://`.
3. Confirme. Aparece **Domínio adicionado. Crie os registros de DNS.**
4. Em **Crie no seu DNS**, copie os registros: um `CNAME` (subdomínio) ou `A`/`AAAA` (domínio raiz) e o `TXT` de posse `_nebular-verify`.
5. No painel do seu provedor de DNS, crie os registros. Com Cloudflare, deixe o registro em **DNS only** (nuvem cinza).
6. Volte ao painel e clique em **Verificar agora**. Se precisar esperar, o botão mostra **Verificar de novo em Ns**.

A verificação também roda sozinha. A propagação pode levar de minutos a algumas horas.

## Estados

| Estado | Significa | O que fazer |
|---|---|---|
| Pendente | Falta DNS ou o TXT de posse | Crie os registros mostrados e verifique |
| Verificando | A plataforma está consultando o DNS | Espere alguns minutos |
| Ativo | No ar; HTTPS emitido | Nada |
| Com erro / mal configurado | O DNS mudou e não aponta mais para a Nebular | Restaure os registros |
| Conflito | O domínio já está ativo em outro projeto | Publique o TXT de posse deste domínio |

Quando algo falha, a tabela **Achado × esperado** mostra o que foi encontrado. Nameservers sozinhos não verificam: crie os registros. Veja [Problemas comuns de domínio](/dominios/problemas-comuns/).

## HTTPS

O certificado é emitido pela Nebular depois que o nome aponta direto para ela. Você não precisa instalar nada. Detalhes em [TLS](/dominios/tls/).

## Mais opções

Redirecionar para um domínio principal, HSTS e curinga ficam em [Redirecionamentos](/dominios/redirecionamentos/) e [Domínio curinga](/dominios/dominio-curinga/). O passo a passo completo, com a API, está em [Domínio próprio](/dominios/dominio-proprio/).

## Próximos passos

- [Domínio próprio (completo)](/dominios/dominio-proprio/)
- [Problemas comuns](/dominios/problemas-comuns/)
- [Subdomínio gerado](/dominios/subdominio-gerado/)
