Aller au contenu

Auto-hébergement

Liste de contrôle pour la production

Ce qu'il faut vérifier sur une instance Notifuse auto-hébergée avant d'en envoyer de vrais emails.

Parcourez cette liste avant qu’une instance auto-hébergée n’envoie sa première vraie campagne. Elle suppose le compose.yaml officiel décrit dans Installation.

Réseau et HTTPS

  • Placez un reverse proxy avec TLS devant Notifuse. compose.yaml sert du HTTP simple sur le port 8081, sur toutes les interfaces sauf si vous définissez HTTP_BIND=127.0.0.1 dans .env, ce qu’il faut faire quand le proxy tourne sur le même serveur. Voir Installation.
  • Faites transmettre par le proxy l’en-tête Host d’origine, ou définissez X-Forwarded-Host. Sans cela, les versions web de vos emails ne s’ouvrent plus (Un point d’accès API public).
  • Définissez le point d’accès API sur l’adresse HTTPS publique, par exemple https://emails.yourcompany.com. L’assistant d’installation préremplit Point d’accès de l’API avec l’adresse de la page : vérifiez-la si vous avez lancé l’assistant en HTTP simple. Notifuse inscrit cette adresse dans les emails, les invitations et les webhooks des fournisseurs. Pour la changer plus tard, suivez Changer de domaine.

Secrets et base de données

  • Générez SECRET_KEY une seule fois, avec openssl rand -base64 32, et gardez-en une copie hors du serveur. Elle chiffre les identifiants enregistrés, et une nouvelle clé seule les rend illisibles. Pour la changer, suivez Remplacer la clé secrète.
  • Donnez à PostgreSQL son propre mot de passe avec DB_PASSWORD dans .env, comme le font les commandes d’installation. Sans lui, compose.yaml utilise postgres.
  • Gardez le port PostgreSQL lié à 127.0.0.1. Le compose.yaml officiel le publie en 127.0.0.1:5433, joignable depuis le serveur lui-même pour psql et les sauvegardes. Si le port 5433 est déjà pris, définissez POSTGRES_HOST_PORT dans .env plutôt que d’ouvrir le port au réseau.
  • Laissez le répertoire qui contient compose.yaml là où il est. Compose nomme le volume de la base d’après lui, et un répertoire renommé démarre une nouvelle installation sur une base vide (Installation).

Email

  • Configurez le serveur SMTP système et envoyez un test avec Tester la connexion dans l’assistant d’installation. Notifuse envoie par ce serveur les codes de connexion et les invitations, donc personne ne peut recevoir de code de connexion tant qu’il ne fonctionne pas. Vous pourrez le modifier plus tard en root dans Paramètres système.
  • Connectez chaque espace de travail à son fournisseur d’email. Le serveur SMTP système ne transporte que les codes de connexion et les invitations ; les espaces de travail configurent leur propre fournisseur pour les campagnes et les emails transactionnels.
  • Authentifiez votre domaine d’envoi (SPF, DKIM, DMARC) auprès de ce fournisseur avant la première campagne. Notifuse ne vérifie pas ces enregistrements, alors contrôlez-les chez le fournisseur. Voir Authentifier votre domaine.
Le panneau Paramètres système : email root, point d'accès de l'API et SMTP système utilisé pour les codes de connexion
Le panneau Paramètres système : email root, point d'accès de l'API et SMTP système utilisé pour les codes de connexion

Sauvegardes

  • Sauvegardez chaque base de données (notifuse_system et chaque base notifuse_ws_…) à intervalles réguliers, et conservez SECRET_KEY avec les dumps, hors du serveur. Sauvegardes donne les commandes.
  • Restaurez au moins une fois une sauvegarde dans une installation vide, et connectez-vous pour vérifier vos espaces de travail, avant de compter sur elle.
  • Une fois la restauration validée, définissez DB_EXPECT_EXISTING=true dans .env. Notifuse refuse alors de démarrer sur une base vide au lieu d’y créer une nouvelle installation.

Mises à jour et télémétrie

  • Décidez de Vérifier les mises à jour et de Télémétrie anonyme, tous deux activés par défaut dans l’assistant d’installation. La vérification des mises à jour signale les nouvelles versions et les correctifs de sécurité sur la liste des espaces de travail. Modifiez l’un ou l’autre plus tard dans Paramètres système (Vérifier les mises à jour, Télémétrie), ou avec les variables CHECK_FOR_UPDATES et TELEMETRY, qui l’emportent sur la console.
  • Fixez la version que vous utilisez avec NOTIFUSE_VERSION dans .env (par exemple NOTIFUSE_VERSION=v44.0), pour qu’une nouvelle copie de compose.yaml ne vous mette pas à jour par surprise. Pour mettre à jour, suivez Passer à une nouvelle version.

Surveillance

  • Surveillez GET /healthz. Il répond 200 avec {"status":"ok"} quand Notifuse atteint sa base système en moins de 2 secondes, et 503 avec {"status":"unavailable"} sinon. compose.yaml l’utilise déjà comme contrôle de santé du conteneur, toutes les 30 secondes.
  • Lisez le log du serveur avec docker compose logs -f api. compose.yaml le limite à cinq fichiers de 10 Mo.