> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velan.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Domínio próprio na área de membros
> Use um endereço seu, como membros.suaempresa.com.br, para a área de membros. Passo a passo e guias por provedor de DNS.
Por padrão, a sua área de membros fica em um subdomínio da Velan, como `suaempresa.club.velan.app`.
Com o **domínio próprio**, seus alunos acessam por um endereço da sua marca, como
`membros.suaempresa.com.br`, com certificado HTTPS emitido e renovado automaticamente pela Velan.
O caminho recomendado é um **subdomínio** (`membros.suaempresa.com.br`, `club.suaempresa.com.br`). O **domínio
raiz** (`suaempresa.com.br`) também é aceito, mas só funciona em provedores de DNS que tenham registro
**ALIAS, ANAME ou CNAME flattening**. Veja [Domínio raiz](#dominio-raiz).
## Como funciona
1. Você informa o subdomínio no painel da Velan.
2. A Velan gera um registro **TXT** que prova que o domínio é seu.
3. Você cria no DNS do seu domínio **dois registros**: o TXT e um **CNAME** apontando para `cname.velan.app`.
4. A Velan confere o TXT, emite o certificado HTTPS e ativa o endereço. A conferência roda a cada 10 minutos.
Depois de ativo, tudo que já funciona hoje continua igual: login dos alunos, cursos, e-mails e links.
Os links antigos em `suaempresa.club.velan.app` continuam abrindo.
## Configuração automática (um clique)
Se o DNS do seu domínio está em um provedor que suporta o padrão **Domain Connect**, o painel da Velan mostra o
botão **Configurar automaticamente** logo depois de você salvar o subdomínio. Você confirma na tela do provedor
e os dois registros são criados sozinhos, sem copiar nada.
Provedores com suporte: **GoDaddy, Cloudflare, IONOS, Squarespace Domains, Plesk** e alguns registradores menores.
Registro.br, Hostinger, HostGator, Locaweb e Namecheap não suportam: nesses, siga o passo a passo manual abaixo.
A configuração automática vale só para subdomínios. Para o domínio raiz, veja [Domínio raiz](#dominio-raiz).
## Passo a passo
No painel da Velan, abra **Área de membros → Configurações → Domínio próprio**, digite o subdomínio
(sem `https://`) e clique em **Salvar domínio**.
Assim que salvar, o painel mostra o registro **TXT** (com um valor único do seu domínio) e o **CNAME**.
Deixe essa tela aberta para copiar os valores.
Entre no painel de DNS onde o seu domínio está hospedado e crie os dois registros abaixo.
Veja o guia do seu provedor mais adiante nesta página.
A Velan confere o DNS a cada 10 minutos. Com os registros corretos, o status no painel passa para
**Ativo** em poucos minutos após a propagação do DNS. Em alguns provedores a propagação leva até 1 hora.
## Os registros
Exemplo para o subdomínio `membros.suaempresa.com.br`. Use os valores que o painel mostra para o seu domínio.
| Tipo | Nome (host) | Valor / destino | Proxy / CDN |
| - | - | - | - |
| TXT | `_velan-verify.membros` | `velan-verify=SEU-TOKEN-AQUI` | não se aplica |
| CNAME | `membros` | `cname.velan.app` | **desligado** |
**O CNAME precisa ficar sem proxy ou CDN.** Na Cloudflare isso significa a nuvem **cinza** ("DNS only"), não a
laranja. Com proxy ligado, a Velan não consegue emitir o certificado e o domínio fica pendente.
Sobre o campo **Nome**: alguns provedores pedem só a parte do subdomínio (`membros` e `_velan-verify.membros`),
outros pedem o nome completo (`membros.suaempresa.com.br` e `_velan-verify.membros.suaempresa.com.br`).
Siga o padrão do seu provedor. Se ele preencher o restante automaticamente, informe só a parte curta.
O registro TXT precisa continuar existindo depois da ativação. Ele é a prova de que o domínio é seu.
## Domínio raiz
Quer usar `suaempresa.com.br` direto, sem subdomínio? O DNS não permite registro CNAME na raiz do domínio
(ela já guarda os registros obrigatórios de SOA e NS). Alguns provedores resolvem isso com um registro especial,
que simula o CNAME na raiz:
| Provedor | Registro para a raiz | Funciona? |
| - | - | - |
| Cloudflare | CNAME em `@` (CNAME flattening automático), proxy desligado | Sim |
| Amazon Route 53 | Registro A com **Alias** | Sim |
| Namecheap | **ALIAS Record** | Sim |
| Hostinger | **CNAME em @** (flattening) ou ALIAS | Sim |
| Squarespace Domains | **ALIAS** | Sim |
| DNSimple, DNS Made Easy, NS1 | **ALIAS / ANAME** | Sim |
| Registro.br | não tem | Não: use um subdomínio |
| GoDaddy | não tem (só redirecionamento) | Não: use um subdomínio |
| cPanel (HostGator, Locaweb e outros) | em geral não tem | Não: use um subdomínio |
Com a raiz, os registros ficam assim (o painel da Velan mostra o Nome como `@`):
| Tipo | Nome (host) | Valor / destino |
| - | - | - |
| TXT | `_velan-verify` | `velan-verify=SEU-TOKEN-AQUI` |
| ALIAS / ANAME / CNAME flattening | `@` | `cname.velan.app` |
Antes de apontar a raiz, confira se ela não está em uso pelo seu site. O registro ALIAS substitui o registro A
da raiz, e o site que estava lá para de abrir. Se o domínio tem site, use um subdomínio para a área de membros.
Se o seu provedor não tem esse registro, a alternativa é mover o DNS do domínio para a Cloudflare (plano gratuito)
e criar os registros lá. Os demais registros do domínio, como e-mail, continuam funcionando se forem copiados.
## Guias por provedor
1. Entre em [dash.cloudflare.com](https://dash.cloudflare.com), escolha o domínio e abra **DNS → Records**.
2. Clique em **Add record**, tipo **TXT**, Name `_velan-verify.membros`, Content `velan-verify=SEU-TOKEN-AQUI`. Salve.
3. Clique em **Add record**, tipo **CNAME**, Name `membros`, Target `cname.velan.app`.
4. **Desligue o Proxy status**: a nuvem precisa ficar **cinza (DNS only)**. Salve.
5. TTL pode ficar em Auto.
Se o subdomínio já existia com a nuvem laranja, edite o registro e troque para DNS only. Enquanto o proxy
estiver ligado, o certificado não é emitido.
1. Entre em [registro.br](https://registro.br), vá em **Meus domínios**, clique no domínio e depois em **Editar zona** (modo avançado).
2. Adicione um registro **TXT**: Nome `_velan-verify.membros`, Dados `velan-verify=SEU-TOKEN-AQUI`.
3. Adicione um registro **CNAME**: Nome `membros`, Dados `cname.velan.app`.
4. Clique em **Salvar alterações**. O Registro.br leva de 10 a 30 minutos para publicar a zona.
Se o domínio usa os servidores DNS de outra empresa (hospedagem, Cloudflare), os registros devem ser criados lá, não no Registro.br.
1. Entre na GoDaddy, vá em **Meus produtos → Domínios**, clique no domínio e em **DNS**.
2. Em **Registros DNS**, clique em **Adicionar novo registro**.
3. Tipo **TXT**: Nome `_velan-verify.membros`, Valor `velan-verify=SEU-TOKEN-AQUI`. Salve.
4. Tipo **CNAME**: Nome `membros`, Valor `cname.velan.app`. Salve.
5. TTL padrão (1 hora) está bom.
1. No hPanel, abra **Domínios**, escolha o domínio e clique em **DNS / Nameservers**.
2. Em **Gerenciar registros DNS**, adicione um registro **TXT**: Nome `_velan-verify.membros`, Conteúdo `velan-verify=SEU-TOKEN-AQUI`.
3. Adicione um registro **CNAME**: Nome `membros`, Destino `cname.velan.app`.
4. Clique em **Adicionar registro** em cada um.
1. No painel da HostGator, abra **Domínios → Zona de DNS** (ou **Editor de zona** no cPanel).
2. Adicione um registro **TXT**: Nome `_velan-verify.membros`, Registro `velan-verify=SEU-TOKEN-AQUI`.
3. Adicione um registro **CNAME**: Nome `membros`, Registro `cname.velan.app`.
4. Salve. No cPanel, confirme que o nome foi gravado como `membros.suaempresa.com.br.` com o ponto final, que o painel adiciona sozinho.
1. No painel da Locaweb, abra **Domínios**, escolha o domínio e clique em **Zona DNS** (ou **Configurar DNS**).
2. Adicione uma entrada **TXT**: Nome `_velan-verify.membros`, Valor `velan-verify=SEU-TOKEN-AQUI`.
3. Adicione uma entrada **CNAME**: Nome `membros`, Valor `cname.velan.app`.
4. Salve as alterações.
1. Em **Domain List**, clique em **Manage** no domínio e abra a aba **Advanced DNS**.
2. Em **Host Records**, clique em **Add New Record**.
3. Tipo **TXT Record**: Host `_velan-verify.membros`, Value `velan-verify=SEU-TOKEN-AQUI`.
4. Tipo **CNAME Record**: Host `membros`, Value `cname.velan.app`.
5. Salve com o ícone de confirmação em cada linha.
1. Em **Domínios**, clique no domínio e abra **DNS → Registros DNS personalizados**.
2. Adicione um registro: Host `_velan-verify.membros`, Tipo **TXT**, Dados `velan-verify=SEU-TOKEN-AQUI`.
3. Adicione um registro: Host `membros`, Tipo **CNAME**, Dados `cname.velan.app`.
4. Salve.
Todo painel de DNS tem uma tela para criar registros. Procure por "DNS", "Zona DNS" ou "Registros DNS",
crie os dois registros da tabela acima e, se existir uma opção de proxy ou CDN no CNAME, deixe desligada.
Se o domínio estiver com os servidores DNS de outra empresa, os registros são criados nessa empresa.
## Conferir se os registros estão certos
Você pode verificar antes mesmo da Velan conferir. Em sites como [dnschecker.org](https://dnschecker.org),
consulte:
* **TXT** de `_velan-verify.membros.suaempresa.com.br`: deve aparecer `velan-verify=SEU-TOKEN-AQUI`.
* **CNAME** de `membros.suaempresa.com.br`: deve aparecer `cname.velan.app`.
No terminal, os comandos equivalentes são:
```bash theme={null}
dig TXT _velan-verify.membros.suaempresa.com.br +short
dig CNAME membros.suaempresa.com.br +short
```
## Problemas comuns
O TXT ainda não foi encontrado. Confira o nome: precisa ser `_velan-verify.` seguido do subdomínio, com o
sublinhado no início. Confira o valor: `velan-verify=` seguido do token exato do painel, sem espaços nem aspas
extras. Aguarde a propagação, que em geral leva minutos, mas pode chegar a 1 hora.
Quase sempre é proxy ou CDN ligado no CNAME. Na Cloudflare, deixe a nuvem cinza. Confira também se o CNAME
aponta exatamente para `cname.velan.app` e se não existe um registro A ou AAAA com o mesmo nome, que
conflita com o CNAME e precisa ser removido.
O cadastro sem o TXT expira em 7 dias e o domínio é removido do painel. Basta cadastrar de novo e criar os
registros. Nada muda para os alunos, que continuam no endereço padrão da Velan.
O provedor provavelmente não tem registro ALIAS ou CNAME flattening, ou o registro foi criado como A com
um IP. Veja a tabela em [Domínio raiz](#dominio-raiz). Se o seu provedor não oferece, troque para um
subdomínio ou mova o DNS para a Cloudflare.
Em **Área de membros → Configurações → Domínio próprio**, altere o endereço ou remova. Ao remover, a área
de membros volta imediatamente para o endereço padrão da Velan. Você pode apagar os registros DNS depois.
O certificado ainda está sendo emitido. Isso acontece logo depois da confirmação do TXT e leva poucos
minutos. Se passar de 1 hora, confira o proxy do CNAME e fale com o suporte.
## Perguntas frequentes
**Preciso pagar algo a mais?** Não. O domínio próprio e o certificado estão incluídos.
**Os links antigos continuam funcionando?** Sim. O endereço padrão em `club.velan.app` continua abrindo
a sua área de membros, e os alunos já logados não precisam entrar de novo.
**Posso usar mais de um domínio?** Hoje é um domínio próprio por área de membros.
**O e-mail de acesso dos alunos vai usar o meu domínio?** Os links dos e-mails passam a usar o seu domínio
assim que ele fica ativo. O remetente dos e-mails continua sendo o da Velan.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.