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

# Installer Notifuse sur votre serveur

> Démarrez Notifuse avec Docker Compose, terminez l'assistant d'installation, créez un espace de travail et envoyez un email de test, en 15 minutes environ.

Vous obtenez Notifuse en marche sur votre serveur, un compte administrateur, un espace de travail et un fournisseur d'email qui vous a envoyé un email de test.

## Avant de commencer

- Un serveur avec Docker Engine 25.0 ou plus récent et Docker Compose v2.24 ou plus récent. Vérifiez avec `docker compose version`.
- Le port 8081 accessible depuis votre navigateur. Notifuse y sert la console et l'API.
- Un serveur SMTP pour les emails de l'instance elle-même : codes de connexion et invitations. Sans lui, vous ne pouvez pas vous connecter.
- Les identifiants du fournisseur d'email avec lequel votre espace de travail enverra : un serveur SMTP, ou un compte Amazon SES avec un expéditeur vérifié. Ce peut être le même serveur SMTP.

## Installer et envoyer

### 1. Télécharger le fichier Compose et créer le .env

Lancez ceci dans un répertoire vide :

```bash
mkdir notifuse && cd notifuse
curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/main/compose.yaml -o compose.yaml

test -e .env || cat > .env <<EOF
SECRET_KEY=$(openssl rand -base64 32)
DB_PASSWORD=$(openssl rand -hex 24)
EOF
```

`SECRET_KEY` chiffre vos données enregistrées. Compose refuse de démarrer sans elle, et Notifuse refuse une clé de moins de 32 octets. Gardez une copie du fichier `.env` : avec une nouvelle clé, vos données enregistrées deviennent illisibles.

`DB_PASSWORD` est le mot de passe PostgreSQL. Sans lui, la base de données utilise `postgres`.

> [!WARNING]
>
> Compose nomme le volume de la base de données d'après ce répertoire. Ne le renommez pas : dans un répertoire renommé ou déplacé, `docker compose up -d` démarre une nouvelle installation sur une base vide.

### 2. Démarrer Notifuse

```bash
docker compose up -d
```

Cette commande récupère l'image Notifuse et la démarre avec son propre PostgreSQL. La console et l'API écoutent sur le port 8081. PostgreSQL n'est joignable que depuis le serveur lui-même, sur `127.0.0.1:5433`.

Pour suivre le log du serveur, lancez `docker compose logs -f api`.

> [!WARNING]
>
> Notifuse sert du HTTP en clair. Avant de faire pointer un domaine vers lui, placez devant un reverse proxy avec TLS. Si ce proxy tourne sur le même serveur, mettez `HTTP_BIND=127.0.0.1` dans `.env` pour que le port 8081 ne réponde que sur le serveur lui-même, puis relancez `docker compose up -d`. [Installation](https://www.notifuse.com/fr/docs/self-hosting/installation.md) traite ce point et tout le reste : variables d'environnement, Docker sans Compose, mises à jour et clé secrète.

### 3. Remplir l'assistant d'installation

Ouvrez `http://<server>:8081`. Tant que l'installation n'est pas terminée, chaque page mène à l'assistant, **Configurez votre instance Notifuse**. Il tient sur une page de cinq panneaux :

1. **Administrateur** : une ou plusieurs adresses **Email root**, qui se connectent en tant que root, et le **Point d'accès de l'API**, prérempli avec l'adresse de la page. Gardez cette adresse pour l'instant : [Changer de domaine](https://www.notifuse.com/fr/docs/self-hosting/changing-domain.md) explique comment passer plus tard à votre domaine en HTTPS.
2. **Envoi des emails système (SMTP)** : **Hôte**, **Port** (587 par défaut), **Utiliser TLS**, **Nom d'utilisateur**, **Mot de passe**, **Email d'expédition** et **Nom d'expéditeur**. Notifuse n'utilise ce serveur que pour les codes de connexion et les invitations. Cliquez sur **Tester la connexion** pour le vérifier.
3. **Mises à jour et télémétrie** : les deux sont activées par défaut. Désactivez-les si vous préférez.
4. **Authentification unique (OpenID Connect)** : facultatif. Passez pour l'instant.
5. **Passerelle SMTP** : facultatif. Passez pour l'instant.

Un réglage déjà fourni dans `.env` apparaît verrouillé, avec le nom de sa variable.

Cliquez sur **Terminer l'installation**. Le serveur redémarre pour appliquer la configuration, ce qui prend en général quelques secondes. Quand **Notifuse est prêt** s'affiche, cliquez sur **Aller à la connexion**.

![L'assistant d'installation : administrateur, envoi des emails système, mises à jour et télémétrie, authentification unique et passerelle SMTP](https://www.notifuse.com/docs/assets/screenshots/setup.png)

### 4. Se connecter

Saisissez le premier email root et cliquez sur **Envoyer le code magique**. Le code arrive par le serveur SMTP réglé dans l'assistant. Tapez le code à 6 chiffres et cliquez sur **Vérifier le code**.

Si aucun code n'arrive, les réglages SMTP système sont faux. Consultez le log du serveur avec `docker compose logs -f api`.

### 5. Créer un espace de travail

L'installation ne crée aucun espace de travail : la console s'ouvre donc sur **Nouvel espace de travail**.

- **Nom de l'espace de travail** : 3 à 32 caractères.
- **ID de l'espace de travail** : généré à partir du nom. Il ne peut contenir que des lettres minuscules et des chiffres, 20 au plus, et il apparaît dans les URL et les requêtes API.
- **URL du site web** : facultatif. Notifuse s'en sert pour trouver votre favicon.

Cliquez sur **Créer un espace de travail**. L'espace de travail est créé avec un contact pour vous et une liste nommée **Test List** à laquelle vous êtes abonné. Seul un utilisateur root peut créer des espaces de travail, et une installation sans [licence](https://www.notifuse.com/fr/docs/self-hosting/licence.md) peut en avoir trois.

### 6. Connecter un fournisseur d'email

Le SMTP système de l'assistant n'envoie pas les emails des espaces de travail. Chaque espace de travail connecte son propre fournisseur.

Allez dans **Paramètres**, puis **Intégrations** sous **Envoi**. Cliquez sur **Ajouter une intégration** et choisissez votre fournisseur dans le groupe **Envoi d'emails**.

Chaque fournisseur demande un **Nom**, au moins un expéditeur (**Ajouter un expéditeur** demande un **Email** et un **Nom**) et un **Débit pour le marketing** en emails par minute, 25 par défaut. Remplissez ensuite les champs propres au fournisseur :

**SMTP**

- **Hôte** : le nom de votre serveur SMTP.
- **Port** : 587 pour STARTTLS, 465 pour TLS dès le premier octet, 25 sans chiffrement.
- **Chiffrement** : laissez **Utiliser TLS** activé, sauf si votre serveur accepte le texte en clair.
- **Nom d'hôte EHLO** : facultatif. Par défaut, c'est l'hôte.
- **Méthode** : **Nom d'utilisateur et mot de passe**, ou **OAuth2** pour une boîte Microsoft 365 ou Google Workspace.
- **Nom d'utilisateur** et **Mot de passe** : laissez-les vides pour un serveur qui accepte les emails sans connexion.

Voir [SMTP](https://www.notifuse.com/fr/docs/integrations/smtp.md) pour OAuth2 et les serveurs courants.

**Amazon SES**

- **Région** : la région AWS où se trouvent vos identités vérifiées.
- **ID de clé d'accès** et **Clé d'accès secrète** : ceux d'un utilisateur IAM autorisé à envoyer avec SES.
- **Isolation par tenant** : facultatif. L'espace de travail obtient sa propre réputation SES et sa propre liste de suppression, et AWS facture par tenant.
- **Avancé** : **Configuration set** et **Tenant SES**, pour des noms que vous gérez vous-même dans AWS. Laissez-les vides.

Voir [Amazon SES](https://www.notifuse.com/fr/docs/integrations/amazon-ses.md) pour les permissions IAM.

Cliquez sur **Enregistrer**. Pour tous les fournisseurs sauf SMTP, Notifuse enregistre alors des webhooks chez le fournisseur, pointés vers votre point d'accès de l'API, pour être informé des remises, des rebonds et des plaintes. Si la carte affiche **Webhooks non enregistrés**, cliquez sur **Enregistrer les webhooks** dans son menu une fois que l'instance répond à son adresse publique.

### 7. Choisir ce que le fournisseur envoie

Un nouveau fournisseur n'envoie rien tant que vous ne lui donnez pas de rôle. Dans le panneau **Envoi d'emails**, choisissez-le pour les **Emails marketing** (newsletters et emails d'automation) et pour les **Emails transactionnels** (notifications envoyées par l'API, Zapier ou Supabase). Confirmez chaque changement avec **Oui**.

Le menu de la carte du fournisseur propose les mêmes choix : **Utiliser pour le marketing** et **Utiliser pour le transactionnel**.

![Le panneau Envoi d'emails avec un fournisseur choisi pour les emails marketing et transactionnels, au-dessus de la carte du fournisseur](https://www.notifuse.com/docs/assets/screenshots/integrations_email_sending.png)

### 8. Envoyer un test

Cliquez sur **Envoyer un test** sur la carte du fournisseur. Saisissez votre adresse dans **Envoyer à** et cliquez sur **Envoyer un email de test**.

## Vérifier que tout fonctionne

- L'email de test est dans votre boîte de réception. Sinon, regardez dans les spams, puis vérifiez les identifiants du fournisseur et l'adresse de l'expéditeur.
- Dans le panneau **Envoi d'emails**, aucun des deux rôles n'affiche **Non défini**.
- `docker compose ps` indique que les services `api` et `postgres` tournent.

## Étapes suivantes

> [card] [Checklist de production](https://www.notifuse.com/fr/docs/self-hosting/production-checklist.md)
>
> Ce qu'il faut vérifier avant que l'instance reçoive du vrai trafic.

> [card] [Comment Notifuse s'organise](https://www.notifuse.com/fr/docs/concepts.md)
>
> Espaces de travail, contacts, listes, segments et les trois façons d'envoyer.

> [card] [Envoyer votre première campagne](https://www.notifuse.com/fr/docs/features/broadcast-campaigns.md)
>
> Rédigez une newsletter et envoyez-la à une liste. La **Test List** est une première audience sans risque.
