# Adicionar um domínio

Para enviar e-mail por um domínio, o mxout precisa de três coisas: um kit de chaves DKIM, os registros DNS publicados e a entrada do domínio em mxout.json.

# Passo 1 — Gerar o kit DKIM

Use o mxout-keygen para gerar o par de chaves RSA-2048 do domínio.

mxout-keygen exemplo.com default ./kits

Substitua exemplo.com pelo domínio real e default pelo nome do selector desejado (ex.: s1, 2026).

O comando cria o arquivo de chave privada:

./kits/exemplo.com.default.key.pem

E imprime o valor do registro TXT DKIM para publicação no DNS. Guarde essa saída — ela é necessária no próximo passo.

Exemplo de saída:

DKIM public key (TXT record value):
v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...

# Passo 2 — Publicar os registros DNS

Acesse o painel DNS do domínio e crie os quatro registros abaixo. Veja detalhes e instruções de verificação em Configurar DNS.

O valor completo do registro DKIM vem da saída do mxout-keygen no passo anterior.

# Passo 3 — Registrar o domínio em mxout.json

Abra o arquivo mxout.json e adicione o domínio na seção domains:

{
  "listen": ":2525",
  "helo_hostname": "mail.exemplo.com",
  "smtp_timeout_secs": 30,
  "domains": {
    "exemplo.com": {
      "selector": "default",
      "key_path": "/etc/mxout/kits/exemplo.com.default.key.pem"
    }
  }
}

Certifique-se de que o arquivo de chave está acessível no caminho indicado em key_path. Se o mxout roda em container, monte o diretório ./kits como volume em /etc/mxout/kits.

Depois salve o arquivo e recarregue o mxout:

systemctl reload mxout

Ou, se estiver em container:

docker restart mxout

Veja todos os campos disponíveis em Configuração.

# Validar o envio

Envie um e-mail de teste para uma conta Gmail:

curl -s -X POST https://<endereço do mxout>/send \
  -H "X-Auth-Token: {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "teste@exemplo.com",
    "to": ["sua-conta@gmail.com"],
    "subject": "Teste DKIM",
    "body_text": "Validando assinatura DKIM."
  }'

No Gmail, abra o e-mail recebido, clique nos três pontos e selecione Mostrar original. Confirme:

• SPF: PASS
• DKIM: PASS
• Assinado por: exemplo.com

Se algum desses itens falhar, consulte Configurar DNS para verificar os registros e o Troubleshooting para diagnóstico via ledger.