Vai al contenuto

Self-hosting

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.

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.
  • 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).
  • 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.

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.
  • 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).

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.
Il pannello Impostazioni di sistema: email di root, endpoint API e SMTP di sistema usato per i codici di accesso
Il pannello Impostazioni di sistema: email di root, endpoint API e SMTP di sistema usato per i codici di accesso

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 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.

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.