> ## 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 per la produzione

> Cosa controllare su un'istanza Notifuse self-hosted prima di inviare email vere.

Scorri questo elenco prima che un'istanza self-hosted invii la sua prima vera campagna. Parte dal presupposto che tu usi il `compose.yaml` ufficiale di [Installazione](https://www.notifuse.com/it/docs/self-hosting/installation.md).

## Rete e HTTPS

- Metti davanti a Notifuse un reverse proxy con TLS. `compose.yaml` serve HTTP semplice sulla porta `8081`, su tutte le interfacce a meno che tu non imposti `HTTP_BIND=127.0.0.1` in `.env`, cosa da fare quando il proxy gira sullo stesso server. Vedi [Installazione](https://www.notifuse.com/it/docs/self-hosting/installation.md#option-1-docker-compose-recommended).
- Fai in modo che il proxy inoltri l'header `Host` originale, oppure imposta `X-Forwarded-Host`. Senza, le versioni web delle tue email non si aprono più ([Un endpoint API pubblico](https://www.notifuse.com/it/docs/self-hosting/installation.md#a-public-api-endpoint)).
- Imposta l'endpoint API sull'indirizzo HTTPS pubblico, come `https://emails.yourcompany.com`. La procedura guidata di configurazione precompila **Endpoint dell’API** con l'indirizzo della pagina, quindi controllalo se l'hai eseguita in HTTP semplice. Notifuse scrive questo indirizzo nelle email, negli inviti e nei webhook dei provider. Per cambiarlo in seguito, segui [Cambiare il dominio](https://www.notifuse.com/it/docs/self-hosting/changing-domain.md).

## Segreti e database

- Genera `SECRET_KEY` una sola volta, con `openssl rand -base64 32`, e conservane una copia fuori dal server. Cifra le credenziali salvate, e una nuova chiave da sola le rende illeggibili. Per cambiarla, segui [Sostituire la chiave segreta](https://www.notifuse.com/it/docs/self-hosting/installation.md#replacing-the-secret-key).
- Dai a PostgreSQL una password propria con `DB_PASSWORD` in `.env`, come fanno i comandi di installazione. Senza, `compose.yaml` usa `postgres`.
- Lascia la porta di PostgreSQL legata a `127.0.0.1`. Il `compose.yaml` ufficiale la pubblica come `127.0.0.1:5433`, raggiungibile dal server stesso per `psql` e i backup. Se la 5433 è occupata, imposta `POSTGRES_HOST_PORT` in `.env` invece di aprire la porta alla rete.
- Lascia dove si trova la directory che contiene `compose.yaml`. Compose dà il suo nome al volume del database, e una directory rinominata avvia una nuova installazione su un database vuoto ([Installazione](https://www.notifuse.com/it/docs/self-hosting/installation.md#option-1-docker-compose-recommended)).

## Email

- Configura il server SMTP di sistema e invia una prova da **Verifica la connessione** nella procedura guidata di configurazione. Notifuse invia tramite questo server i codici di accesso e gli inviti, quindi nessuno può ricevere un codice di accesso finché non funziona. Puoi cambiarlo in seguito come root in **Impostazioni di sistema**.
- Collega ogni workspace al suo provider email. Il server SMTP di sistema trasporta solo codici di accesso e inviti; i workspace configurano il proprio provider per le campagne e le email transazionali.
- Autentica il tuo dominio di invio (SPF, DKIM, DMARC) presso quel provider prima della prima campagna. Notifuse non controlla questi record, quindi verificali presso il provider. Vedi [Autentica il tuo dominio](https://www.notifuse.com/it/docs/deliverability/authenticate-your-domain.md).

![Il pannello Impostazioni di sistema: email di root, endpoint API e SMTP di sistema usato per i codici di accesso](https://www.notifuse.com/docs/assets/screenshots/system_settings.png)

## Backup

- Fai il backup di ogni database (`notifuse_system` e ogni database `notifuse_ws_…`) a intervalli regolari, e conserva `SECRET_KEY` insieme ai dump, fuori dal server. [Backup](https://www.notifuse.com/it/docs/self-hosting/backups.md) riporta i comandi.
- Ripristina almeno una volta un backup in un'installazione vuota, e accedi per controllare i tuoi workspace, prima di farci affidamento.
- Quando il ripristino funziona, imposta `DB_EXPECT_EXISTING=true` in `.env`. Notifuse si rifiuterà allora di avviarsi su un database vuoto invece di crearci sopra una nuova installazione.

## Aggiornamenti e telemetria

- Decidi cosa fare con **Verifica aggiornamenti** e **Telemetria anonima**, entrambi attivi per impostazione predefinita nella procedura guidata di configurazione. Il controllo degli aggiornamenti mostra le nuove versioni e le correzioni di sicurezza nell'elenco dei workspace. Puoi cambiarli in seguito in **Impostazioni di sistema** (**Controlla aggiornamenti**, **Telemetria**), oppure con le variabili `CHECK_FOR_UPDATES` e `TELEMETRY`, che prevalgono sulla console.
- Fissa la release che usi con `NOTIFUSE_VERSION` in `.env` (per esempio `NOTIFUSE_VERSION=v44.0`), così una nuova copia di `compose.yaml` non ti aggiorna a sorpresa. Quando aggiorni, segui [Aggiornare a una nuova release](https://www.notifuse.com/it/docs/self-hosting/upgrading.md).

## Monitoraggio

- Tieni d'occhio `GET /healthz`. Risponde `200` con `{"status":"ok"}` quando Notifuse raggiunge il suo database di sistema entro 2 secondi, e `503` con `{"status":"unavailable"}` altrimenti. `compose.yaml` lo usa già come health check del container, ogni 30 secondi.
- Leggi il log del server con `docker compose logs -f api`. `compose.yaml` lo limita a cinque file da 10 MB.
