# Configuração

O mxout lê a configuração de um arquivo JSON e de variáveis de ambiente. Segredos (token de auth) e chaves DKIM nunca ficam embutidos no binário — chegam via variável de ambiente e arquivos montados externamente.

# Arquivo de configuração (mxout.json)

O caminho do arquivo é definido pela variável MXOUT_CONFIG. O valor padrão é mxout.json no diretório de trabalho. Em container, o caminho convencional é /etc/mxout/mxout.json.

# Campos

# Estrutura de `domains`

Cada chave do objeto domains é o domínio do remetente (deve corresponder ao domínio do campo from no /send).

# Exemplo completo

{
  "listen": "0.0.0.0:8080",
  "helo_hostname": "mail.exemplo.com",
  "smtp_timeout_secs": 30,
  "domains": {
    "exemplo.com": {
      "selector": "mail",
      "key_path": "/etc/mxout/keys/exemplo.com.pem"
    },
    "outro-dominio.com": {
      "selector": "mxout",
      "key_path": "/etc/mxout/keys/outro-dominio.com.pem"
    }
  }
}

Segredos não ficam neste arquivo. O token de administração vem da variável MXOUT_AUTH_TOKEN; as credenciais de cliente são criadas pela API e guardadas como bcrypt no banco de estado — ver Clientes.

A configuração é reescrita pelo próprio serviço. Endpoints como POST /domains e PUT /ratelimit persistem no arquivo. Para editar à mão, pare o container antes — com ele no ar, a alteração é sobrescrita a partir da memória.

# Variáveis de ambiente

# Sobre `MXOUT_AUTH_TOKEN`

Se a variável estiver ausente ou vazia, o endpoint /send fica acessível sem autenticação. O mxout registra um aviso visível nos logs na inicialização. Use somente em rede privada com controle de acesso na camada de rede.

# Sobre `MXOUT_DNS`

Imagens baseadas em scratch não possuem /etc/resolv.conf. Sem MXOUT_DNS, o mxout não consegue resolver registros MX. Defina esta variável sempre que rodar o container a partir de uma imagem mínima.

# Chaves DKIM

As chaves privadas DKIM são arquivos PEM referenciados por key_path no mxout.json. Elas devem ser montadas no container como volumes somente-leitura. Nunca inclua chaves privadas em imagens Docker ou repositórios.

Para gerar um par de chaves, consulte mxout-keygen.

Para publicar o registro DNS correspondente, consulte Configurar DNS.