> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar um domínio

> Cria um domínio principal ou um subdomínio na conta de um cliente. O domínio principal já nasce com site, zona de DNS e e-mail, e as outras abas do formulário podem ser ajustadas…

**Caminho no painel:** **Domínios** > **Domínios** > **Adicionar domínio**

## 1. Escolher o proprietário

![Tela Adicionar domínio com o campo Proprietário e o botão Continuar](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-proprietario-admin.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=eaa693c0132b37b679b92caf7ae15baa)

1. Na lista de domínios, clique em **Adicionar domínio**.
2. Em **Proprietário**, escolha o cliente.
3. Clique em **Continuar**.

O painel explica por que o dono vem antes: *"Você deve selecionar um proprietário
para o domínio primeiro, antes de poder definir outras configurações do domínio."*
O formulário se monta pelo que **aquele cliente** pode usar: sem a permissão
Perl/CGI, por exemplo, o caminho do CGI não aparece na aba **Interpretador**.

**O limite de domínios do cliente não vale para você.** O administrador sempre
pode atribuir domínios, como explica
[Limites e permissões do cliente](/keyhelp-admin/limites-e-permissoes-do-cliente).

## 2. Preencher a aba Geral

![Aba Geral do formulário de domínio novo, com Proprietário, Tipo do domínio, nome, www, destino, diretório e Desativar DNS](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-adicionar-admin.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=f3dd674298fa108d87f79131aa3b7fb6)

4. Em **Tipo do domínio**, deixe **Domínio principal**. Para subdomínio, ver a seção
   seguinte.
5. Em **Nome completo do domínio**, digite o nome, sem `http://`.
6. Confira **Criar [www](http://www). subdomínio** e o **Diretório**. O painel já sugere uma pasta
   com o nome do domínio, como `/meusite.com.br/`.
7. Clique em **Salvar**.

| Campo | Vem com | O que faz |
| - | - | - |
| **Proprietário** | o cliente escolhido | só mostra. Para trocar depois, ver [Trocar o proprietário de um domínio](/keyhelp-admin/trocar-proprietario-do-dominio) |
| **Nome completo do domínio** | vazio | letra maiúscula vira minúscula ao salvar |
| **Criar [www](http://www). subdomínio** | marcado | cria também o `www.` como um **subdomínio separado**, com o mesmo diretório |
| **Destino do domínio / Tipo de hospedagem** | **Diretório local** | ou **Encaminhamento**, ver abaixo |
| **Diretório** | `/`, e muda sozinho ao digitar o nome | a pasta do site, dentro de `/www` da conta. Se não existir, o painel cria com uma página padrão dentro. Se já existir, fica como está |
| **Desativar DNS** | desmarcado | marcado, o servidor não responde pelo domínio. Ver [Editor de DNS](/keyhelp-admin/editor-de-dns) |

> [!WARNING]
>
> **Mexer no nome depois apaga a pasta escrita à mão**
>
> O painel reescreve o **Diretório** toda vez que o nome, o tipo ou o domínio da
> lista mudam. Quem escreve `/site-novo/` e depois corrige uma letra do nome volta a
> ter `/meusite.com.br/` no campo. Para usar outra pasta, escreva-a **por último**, e
> confira antes de salvar.

**O caminho não sai de `/www`.** Um `..` digitado vira `.`: `/../pasta/` é gravado
como `/www/./pasta/`.

Com o domínio salvo, o painel responde *"Os seguintes domínios foram criados com
sucesso."* seguido dos nomes, **www incluído**. O site, a zona de DNS e o e-mail
ficam prontos no minuto seguinte, quando o **S** da lista sai de *Processando*.

**A pasta nova não nasce vazia.** O painel põe nela a página padrão. De fábrica,
são um `index.html` e um `bulma.min.css`, que formam uma página em inglês com o
título *Domain Default Page* e a palavra *Welcome*. É ela que aparece ao abrir o
domínio, até alguém trocar os arquivos. A página se muda em
[Página de Domínio Padrão](/keyhelp-admin/pagina-de-dominio-padrao).

As outras abas (Segurança, E-mail, Interpretador, Configurações do Apache e
Configurações avançadas) são as mesmas da edição, e estão em
[Editar um domínio](/keyhelp-admin/editar-dominio).

## Encaminhamento em vez de site

Marcando **Encaminhamento**, o campo **Diretório** dá lugar a dois outros, em
destaque na imagem:

![Aba Geral com Encaminhamento marcado: Endereço de destino preenchido e Tipo de encaminhamento com o Código 302 marcado](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-adicionar-encaminhamento.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=5a5923a02efd364048f1fee9f59500ac)

| Campo | O que pede |
| - | - |
| **Endereço de destino** | o endereço completo, com `http://` ou `https://` na frente. Sem isso o navegador recusa com *"Insira um URL."* |
| **Tipo de encaminhamento** | **Movido temporariamente (Código 302)**, que vem marcado, ou **Movido permanentemente (Código 301)** |

A tela explica a diferença entre os dois tipos, que é para os buscadores:

| Tipo | O que o painel diz |
| - | - |
| **Movido permanentemente (Código 301)** | *"Isso não afeta o ranking da página do seu mecanismo de pesquisa."* |
| **Movido temporariamente (Código 302)** | *"A URL original permanece no índice do mecanismo de pesquisa."* |

**O caminho e os parâmetros vão junto, nos dois tipos.** Com destino
`https://www.example.org/`, um acesso a `/pagina?x=1` foi levado para
`https://www.example.org/pagina?x=1`, com o código 301 e com o 302.

> [!NOTE]
>
> **O www não é encaminhado junto**
>
> O `www.` é um subdomínio separado. Encaminhar o domínio principal não mexe nele,
> e ele continua mostrando a pasta que tinha. Para levar os dois, edite também o
> `www.`.

## Subdomínio

![Aba Geral com Subdomínio marcado: o nome se divide em um campo e uma lista de domínios](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-adicionar-subdominio.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=27483b7cafe1eaf480dbcb86acad779b)

1. Em **Tipo do domínio**, marque **Subdomínio**.
2. Em **Nome completo do domínio**, em destaque na imagem, digite a parte da frente,
   como `loja`, e escolha na lista o domínio principal.
3. Confira o **Diretório** e clique em **Salvar**.

A lista traz os domínios principais **do proprietário escolhido**. O subdomínio
pode ter mais de um nível: `blog.loja` dentro de `seudominio.com.br` vira
`blog.loja.seudominio.com.br`.

**O Diretório sugerido junta os dois**, como `/loja.seudominio.com.br/`, e vale a
mesma regra do domínio principal: mexer no nome depois reescreve a pasta.

**Marcar Subdomínio muda outras duas abas sem avisar:**

| Aba | O que muda |
| - | - |
| **Geral** | some **Criar [www](http://www). subdomínio** |
| **Interpretador** | a versão do PHP passa para **Como domínio principal** |
| **E-mail** | **O domínio pode ser usado para e-mail** é desmarcado. Voltando para **Domínio principal**, ele é marcado de novo, e o PHP volta para a versão padrão. Na área do cliente o e-mail não muda |

## As mensagens

| Situação | O painel responde |
| - | - |
| Domínio criado | *"Os seguintes domínios foram criados com sucesso."* |
| **Continuar** sem escolher o proprietário | *"Selecione um proprietário para o domínio."* |
| Nome com espaço ou caractere inválido | *"Entrada inválida no campo Nome completo do domínio."* |
| `http://` digitado no nome | a mesma, e *"Entrada inválida no campo Diretório / Endereço de destino."* |
| O nome já existe no servidor, em qualquer conta | *"O domínio X já existe."* |
| Subdomínio sem a parte da frente ou sem o domínio principal | *"Selecione um nome de domínio válido."* |

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **A pasta que escrevi virou outra** | o nome foi mexido depois da pasta, e o painel reescreveu a sugestão | editar o domínio e escrever a pasta certa. Da próxima vez, escrever a pasta por último |
| **O subdomínio foi criado sem e-mail** | marcar **Subdomínio** desmarca o e-mail na área do administrador | ligar na aba **E-mail** do subdomínio |
| O encaminhamento funciona e o `www.` não | o `www.` é outro domínio | encaminhar o `www.` também |
| **Não acho o domínio na lista de subdomínio** | a lista mostra só os domínios do proprietário escolhido | conferir se escolheu o cliente certo |
| *"O domínio X já existe."* e ele não aparece na lista | ele pode estar em outra conta, ou escondido por busca ou por **Visualização personalizada** | buscar pelo nome com a busca limpa |
| Salvei e o site ainda não responde | a criação é aplicada no minuto seguinte | esperar o **S** ficar verde |
| O domínio abre uma página *Welcome* em inglês | é a página padrão que o painel põe na pasta nova | enviar os arquivos do site para a pasta |
| Não aparece o caminho do CGI | o cliente não tem a permissão Perl/CGI | ligar em [Limites e permissões do cliente](/keyhelp-admin/limites-e-permissoes-do-cliente) |

## Ver também

* [Domínios](/keyhelp-admin/dominios), a lista
* [Editar um domínio](/keyhelp-admin/editar-dominio), as outras cinco abas
* [Adicionar um domínio (área do cliente)](/keyhelp/adicionar-dominio), o que muda quando é o cliente que cria
* [Página de Domínio Padrão](/keyhelp-admin/pagina-de-dominio-padrao), a página que a pasta nova recebe


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.