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

# 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](https://www.notifuse.com/fr/docs/self-hosting/installation.md).

## 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](https://www.notifuse.com/fr/docs/self-hosting/installation.md#option-1-docker-compose-recommended).
- 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](https://www.notifuse.com/fr/docs/self-hosting/installation.md#a-public-api-endpoint)).
- 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](https://www.notifuse.com/fr/docs/self-hosting/changing-domain.md).

## 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](https://www.notifuse.com/fr/docs/self-hosting/installation.md#replacing-the-secret-key).
- 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](https://www.notifuse.com/fr/docs/self-hosting/installation.md#option-1-docker-compose-recommended)).

## 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](https://www.notifuse.com/fr/docs/deliverability/authenticate-your-domain.md).

![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](https://www.notifuse.com/docs/assets/screenshots/system_settings.png)

## 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](https://www.notifuse.com/fr/docs/self-hosting/backups.md) 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](https://www.notifuse.com/fr/docs/self-hosting/upgrading.md).

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