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

# Checklist de produção

> O que verificar numa instância auto-hospedada do Notifuse antes de enviar emails reais por ela.

Percorra esta lista antes que uma instância auto-hospedada envie a sua primeira campanha real. Ela parte do `compose.yaml` oficial de [Instalação](https://www.notifuse.com/pt/docs/self-hosting/installation.md).

## Rede e HTTPS

- Coloque um proxy reverso com TLS na frente do Notifuse. O `compose.yaml` serve HTTP simples na porta `8081`, em todas as interfaces, a menos que você defina `HTTP_BIND=127.0.0.1` no `.env`, o que convém fazer quando o proxy roda no mesmo servidor. Veja [Instalação](https://www.notifuse.com/pt/docs/self-hosting/installation.md#option-1-docker-compose-recommended).
- Faça o proxy repassar o cabeçalho `Host` original, ou defina `X-Forwarded-Host`. Sem isso, as versões web dos seus emails deixam de abrir ([Um endpoint de API público](https://www.notifuse.com/pt/docs/self-hosting/installation.md#a-public-api-endpoint)).
- Defina o endpoint da API com o endereço HTTPS público, como `https://emails.yourcompany.com`. O assistente de configuração preenche **Endpoint da API** com o endereço da página, então confira esse valor se você rodou o assistente em HTTP simples. O Notifuse grava esse endereço nos emails, nos convites e nos webhooks dos provedores. Para alterá-lo depois, siga [Mudar de domínio](https://www.notifuse.com/pt/docs/self-hosting/changing-domain.md).

## Segredos e banco de dados

- Gere a `SECRET_KEY` uma única vez, com `openssl rand -base64 32`, e guarde uma cópia fora do servidor. Ela criptografa as credenciais armazenadas, e uma chave nova sozinha as deixa ilegíveis. Para trocá-la, siga [Substituir a chave secreta](https://www.notifuse.com/pt/docs/self-hosting/installation.md#replacing-the-secret-key).
- Dê ao PostgreSQL uma senha própria com `DB_PASSWORD` no `.env`, como fazem os comandos de instalação. Sem ela, o `compose.yaml` usa `postgres`.
- Mantenha a porta do PostgreSQL ligada a `127.0.0.1`. O `compose.yaml` oficial a publica como `127.0.0.1:5433`, acessível a partir do próprio servidor para o `psql` e os backups. Se a 5433 estiver ocupada, defina `POSTGRES_HOST_PORT` no `.env` em vez de abrir a porta para a rede.
- Deixe o diretório que contém o `compose.yaml` onde ele está. O Compose dá ao volume do banco de dados o nome desse diretório, e um diretório renomeado inicia uma nova instalação num banco de dados vazio ([Instalação](https://www.notifuse.com/pt/docs/self-hosting/installation.md#option-1-docker-compose-recommended)).

## Email

- Configure o servidor SMTP do sistema e envie um teste em **Testar conexão** no assistente de configuração. O Notifuse envia os códigos de login e os convites por ele, então ninguém recebe um código de login enquanto ele não funcionar. Você pode alterá-lo depois, como root, em **Configurações do Sistema**.
- Conecte cada workspace ao seu provedor de email. O servidor SMTP do sistema só leva os códigos de login e os convites; os workspaces configuram o seu próprio provedor para as campanhas e os emails transacionais.
- Autentique o seu domínio de envio (SPF, DKIM, DMARC) nesse provedor antes da primeira campanha. O Notifuse não verifica esses registros, então confira-os no provedor. Veja [Autentique o seu domínio](https://www.notifuse.com/pt/docs/deliverability/authenticate-your-domain.md).

![O painel Configurações do Sistema: email do root, endpoint da API e o SMTP do sistema usado para os códigos de login](https://www.notifuse.com/docs/assets/screenshots/system_settings.png)

## Backups

- Faça backup de todos os bancos de dados (`notifuse_system` e cada banco `notifuse_ws_…`) de forma programada, e guarde a `SECRET_KEY` junto com os dumps, fora do servidor. [Backups](https://www.notifuse.com/pt/docs/self-hosting/backups.md) traz os comandos.
- Restaure um backup numa instalação vazia pelo menos uma vez e entre para conferir os seus workspaces antes de contar com ele.
- Quando a restauração funcionar, defina `DB_EXPECT_EXISTING=true` no `.env`. O Notifuse passa então a se recusar a iniciar num banco de dados vazio em vez de criar uma nova instalação nele.

## Atualizações e telemetria

- Decida sobre **Verificar atualizações** e **Telemetria anônima**, ambas ativadas por padrão no assistente de configuração. A verificação de atualizações mostra novas versões e correções de segurança na lista de workspaces. Altere qualquer uma delas depois em **Configurações do Sistema** (**Verificar Atualizacoes**, **Telemetria**) ou com as variáveis `CHECK_FOR_UPDATES` e `TELEMETRY`, que prevalecem sobre o console.
- Fixe a versão que você roda com `NOTIFUSE_VERSION` no `.env` (por exemplo, `NOTIFUSE_VERSION=v44.0`), para que uma nova cópia do `compose.yaml` não atualize a sua instalação de surpresa. Quando for atualizar, siga [Atualizar para uma nova versão](https://www.notifuse.com/pt/docs/self-hosting/upgrading.md).

## Monitoramento

- Monitore `GET /healthz`. Ele responde `200` com `{"status":"ok"}` quando o Notifuse alcança o banco de dados do sistema em até 2 segundos, e `503` com `{"status":"unavailable"}` caso contrário. O `compose.yaml` já o usa como verificação de saúde do contêiner, a cada 30 segundos.
- Leia o log do servidor com `docker compose logs -f api`. O `compose.yaml` o limita a cinco arquivos de 10 MB.
