> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/smtp.md).

# SMTP

Cette page fournit des instructions pour la configuration et l’administration de SMTP dans un système VergeOS. [Abonnements](/run-the-platform/fr/administration-systeme/subscriptions-overview.md) (utilisé pour les alertes et notifications système) repose sur une configuration SMTP efficace.

{% hint style="info" %}
**Envoyer directement ou via un relais SMTP**

SMTP peut être configuré pour envoyer des e-mails directement depuis le serveur de messagerie VergeOS intégré -OU- via un serveur de messagerie relais.
{% endhint %}

{% hint style="success" %}
Comme SMTP peut impliquer une configuration intrinsèquement complexe et sujette aux erreurs (DNS, enregistrements DNS inversés, règles de pare-feu, etc.), certains clients choisissent d’utiliser un service commercial de relais d’e-mail pour des raisons de facilité d’utilisation, de sécurité et de conformité. Le fournisseur de ce service peut fournir les paramètres de relais appropriés pour votre configuration SMTP.
{% endhint %}

## Configuration SMTP

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. Cliquez sur **Modifier les paramètres** dans le menu de gauche.
3. Configurer **paramètres :**
   * **Utiliser TLS :** active/désactive le chiffrement TLS ; doit être défini pour correspondre aux exigences du système cible lors de l’utilisation d’un hôte relais de messagerie. Lorsqu’il est pris en charge, utilisez toujours TLS.
   * **Nom d'hôte :** Lors de l’utilisation du serveur SMTP intégré, veillez à utiliser un FQDN valide qui identifie clairement son rôle, assurez-vous que le nom d’hôte se résout vers la bonne adresse IP à l’aide du DNS, et vérifiez que des enregistrements SPF, DMARC et DNS inversés appropriés sont en place pour le nom d’hôte. Le nom d’hôte spécifique peut également être important lors de l’utilisation d’un relais, selon les exigences et les politiques du serveur de relais.
   * **Nom d’expéditeur :** le nom affiché de l’expéditeur à apparaître dans les messages e-mail
   * **Adresse d’expéditeur :** l’adresse e-mail source à apparaître dans les messages e-mail
   * **Hôte relais :** adresse du serveur relais de messagerie (laisser vide pour un envoi direct)
   * **Port relais :** port TCP utilisé par l’hôte relais, par ex. 25 (non chiffré), 587 (TLS), 465 (SSL/héritage obsolète) ; laisser vide pour un envoi direct
   * **Utiliser l’autorisation SASL :** En général, des identifiants d’authentification valides seront requis lors de l’utilisation d’un hôte relais ; activez cette option pour saisir le nom d’utilisateur et le mot de passe nécessaires pour accéder au serveur relais.
4. Cliquez sur **Soumettre** pour enregistrer la configuration.

## Tester la configuration SMTP

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. Cliquez sur **Envoyer un e-mail de test** dans le menu de gauche.
3. Saisissez une **adresse e-mail** à laquelle envoyer.
4. Cliquez sur **Envoyer**.
5. Reportez-vous à la [Dépannage](#smtp-troubleshooting) section si le message de test n’est pas reçu.

## Gestion de la file d’attente SMTP

Le **File de messages** contient les messages e-mail en attente d’envoi.

### Supprimer la file d’attente SMTP

La suppression de la file d’attente SMTP peut être nécessaire dans des situations liées à la livraison des e-mails, comme un important arriéré après une longue interruption de SMTP ou lors du dépannage, afin de repartir de zéro. Les instructions suivantes supprimeront toutes les entrées de la file d’attente de messagerie et ces entrées ne seront pas recréées.

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. **Évaluez les entrées de la file avant de supprimer :** les entrées les plus récentes sont affichées dans la ***File de messages*** section de cette page ; pour afficher une file plus grande, cliquez sur l’entrée **File de messages** dans le menu de gauche.
3. Cliquez sur **Supprimer la file** dans le menu de gauche.

### Vider (accélérer) la file d’attente SMTP

Vider la file d’attente SMTP accélère l’envoi des messages en forçant le serveur de messagerie à réévaluer et à tenter d’envoyer chaque entrée de la file. Cette opération est souvent utilisée lorsqu’un grand nombre de messages sont restés bloqués à la suite d’un problème précédent (mauvaise configuration, panne réseau, retard du service, etc.) qui peut désormais être résolu. Vider la file ne supprime pas les messages, mais accélère le processus d’envoi.

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. Cliquez sur **Vider la file** dans le menu de gauche.
3. Cliquez sur **Oui** pour confirmer l’opération.

## Journaux SMTP

### Afficher un journal des messages envoyés (journal de messagerie)

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. Affichez les entrées les plus récentes dans la **journal de messagerie** section du tableau de bord.
3. Pour afficher davantage d’entrées (plus anciennes), cliquez sur **journal de messagerie** dans le menu de gauche. **Suivant/Précédent** les boutons en bas de la page vous permettent de parcourir les pages de gros journaux.

### Afficher les événements système SMTP

1. Commencez par le **Tableau de bord SMTP (Système > SMTP)**.
2. Affichez les entrées les plus récentes dans la **Journaux** section en bas du tableau de bord.
3. Pour afficher davantage d’entrées (plus anciennes), cliquez sur **Journaux** dans le menu de gauche. **Suivant/Précédent** les boutons en bas de la page vous permettent de parcourir les pages de gros journaux.

## Rapports SMTP

Les rapports SMTP fournissent un **résumé de l’activité SMTP récente**, contenant des informations telles que les avertissements, les erreurs, les octets envoyés/reçus, le nombre de messages par destinataires et expéditeurs, etc. Utilisez les options du menu de gauche pour exécuter **Rapport d’aujourd’hui** ou **Rapport d’hier**.

## Dépannage SMTP

### Vérifier les dossiers de SPAM

Vérifiez que les messages ne sont pas envoyés dans le dossier SPAM/courrier indésirable du destinataire.

### Vérifier les journaux

Les messages d’erreur dans le journal SMTP peuvent fournir des informations lorsque les e-mails échouent, par exemple des avertissements concernant des paramètres SMTP incorrects ou SMTP désactivé, etc. Vérifiez la ***Journaux*****&#x20;section en bas** de la page SMTP.

### Vérifier les règles de pare-feu et les politiques réseau appropriées

Les connexions SMTP sortantes sont généralement bloquées par défaut. Assurez-vous que les ports 25, 587 ou 465 (selon votre configuration) sont ouverts et autorisés ; dans certains cas, cela peut nécessiter de contacter votre fournisseur de services.

### Lors de l’utilisation d’un relais :

**Confirmer les paramètres du relais**

* Certains serveurs de messagerie nécessitent des autorisations explicites de relais. Assurez-vous que le serveur de messagerie autorise votre système VergeOS à relayer des messages, généralement en activant l’authentification ou en ajoutant les adresses IP à la liste blanche.
* Vous devrez peut-être configurer le champ « Adresse d’expéditeur » pour utiliser le même domaine que celui vers lequel vous envoyez des e-mails. En général, votre hôte relais dispose des enregistrements SPF/DMARC/DNS inversé corrects pour votre domaine, mais n’est pas autorisé à envoyer des e-mails depuis l’adresse <system@cloud.verge.io> par défaut du système.
* Confirmez que l’adresse du serveur et le port corrects sont configurés pour le serveur relais. Vérifiez que vous utilisez le nom/l’adresse attendu par le système de messagerie relais.
* Confirmez que le paramètre TLS est conforme aux exigences du serveur relais. De nombreux serveurs de messagerie nécessitent une connexion sécurisée TLS.

{% hint style="success" %}
**Certains serveurs de messagerie utiliseront STARTTLS, où la connexion commence non chiffrée sur un port SMTP standard (25 ou 587), puis le chiffrement est négocié après l’établissement de la connexion.**
{% endhint %}

### Envoi direct :

**Vérifier les enregistrements SPF/DMARC/DNS inversés**\
Si les e-mails sont marqués comme spam ou n’arrivent pas à destination, assurez-vous que les enregistrements DNS inversés sont corrects et que votre domaine dispose d’enregistrements SPF (Sender Policy Framework) et DMARC (Domain-based Message Authentication, Reporting & Conformance) corrects. Lorsque ces enregistrements ne correspondent pas correctement à votre système, les messages tentés peuvent être détectés comme une usurpation d’identité, ce qui entraîne des échecs de livraison et/ou des e-mails signalés comme suspects. Des usurpations répétées peuvent faire mettre votre domaine/IP sur liste noire, ce qui peut affecter les futures livraisons d’e-mails.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/fr/administration-systeme/smtp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
