Stalwart : installer un serveur mail complet sur VPS
Découvrez comment Stalwart remplace Postfix et Dovecot via un binaire Rust unique. Analysez les limites réelles et déterminez si Mailcow reste préférable pour votre usage.
Ce que Stalwart regroupe dans un seul binaire
Stalwart est un serveur mail que vous exécutez sur un VPS sous la forme d'un unique binaire Rust. Il répond aux protocoles SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV et WebDAV depuis le même processus, et il intègre son propre filtre anti-spam, son propre stockage de messages et son propre client ACME. Une pile conventionnelle effectue ce même travail avec Postfix, Dovecot, Rspamd, une base de données pour les comptes et un outil de certificat séparé. Stalwart remplace tout cela par une seule unité de service et un fichier de configuration situé à /etc/stalwart/config.json.
Chaque chiffre, nom de paramètre et commande ci-dessous est cité de la documentation, des pages de release et du script d'installation de Stalwart. Nous les avons lus pour la première fois le 28 août 2026 pour la version v0.16.19 (publiée le 24 août 2026) et nous les avons vérifiés à nouveau le 12 octobre 2026, lorsque la version la plus récente était la v0.16.26. Nous les avons contrôlés une nouvelle fois le 27 octobre 2026, le lendemain de la publication de Stalwart v1.0.0 (26 octobre 2026). Nous avons revérifié les sources le 29 octobre 2026, lorsque la version la plus récente était la v1.0.1, publiée le 28 octobre 2026. Nous avons revérifié les sources le 11 novembre 2026, lorsque la version la plus récente était la v1.1.0, publiée le 9 novembre 2026. Ce sont des commandes que vous devez exécuter sur votre propre serveur. Chacune est suivie de la vérification qui vous indique si elle a fonctionné.
Stalwart est distribué sous une double licence : GNU Affero General Public License v3.0 (AGPL-3.0) et Stalwart Enterprise License v2. Certaines fonctionnalités sont réservées à l'édition entreprise. La liste des points de terminaison HTTP documentée marque /scim/v2/* ces éléments. Lisez les termes de la licence avant de planifier un déploiement basé sur une fonctionnalité que vous n'avez pas testée vous-même.
Un seul binaire réduit réellement le nombre de pièces mobiles. Cela ne réduit pas les deux facteurs qui déterminent si votre courrier arrive à destination.
Le port 25 et la réputation DNS ne dépendent pas du logiciel utilisé
Le port TCP 25 sortant est le premier obstacle. De nombreux fournisseurs de VPS le bloquent par défaut sur les nouveaux comptes ; un port 25 bloqué signifie que votre serveur ne peut pas transmettre de courrier directement au serveur mail d'un tiers. Testez-le avant d'installer quoi que ce soit.
sudo apt update && sudo apt install -y netcat-openbsd
nc -vz -w 5 alt1.aspmx.l.google.com 25Un résultat sain affiche Connection to alt1.aspmx.l.google.com ... 25 port [tcp/smtp] succeeded! en environ une seconde. Un blocage se manifeste de deux manières. Si les paquets sont abandonnés en amont, aucun signal de réinitialisation ne vous est renvoyé, donc nc reste en attente pendant cinq secondes complètes puis affiche nc: connect to alt1.aspmx.l.google.com port 25 (tcp) failed: Connection timed out. Si le pare-feu les rejette, il renvoie une erreur ICMP (le rejet de netfilter envoie "port unreachable" sauf instruction contraire, comme "administratively prohibited"), l'échec est donc immédiat, généralement sous la forme Connection refused ou No route to host. Dans les deux cas, ouvrez un ticket auprès de votre fournisseur.
Si le fournisseur refuse de l'ouvrir, la seule solution est un relais. Stalwart peut transmettre tout le courrier sortant à un smarthost via une route de relais (Relay route), dont le port par défaut est 25 mais qui accepte toute valeur de 1 à 65535, avec une option implicitTls et des champs authUsername et authSecret pour un relais authentifié sur 465 ou 587. Votre courrier est alors envoyé sous la réputation du relais, et non la vôtre.
Le second obstacle est la perception de votre adresse IP et de votre domaine par les réseaux destinataires. Cela concerne le DNS inverse (reverse DNS) sur l'IP, SPF, DKIM, DMARC et l'historique d'envoi du bloc d'adresses dans lequel vous vous trouvez. La page de configuration DNS de Stalwart, telle que consultée le 28 août 2026, était claire sur l'endroit où cette opération doit être effectuée : les enregistrements DNS inverses "sont généralement configurés par le fournisseur d'hébergement, et non par Stalwart lui-même". Stalwart peut publier et maintenir les autres enregistrements DNS via l'API d'un fournisseur DNS pris en charge, mais le DNS inverse et la réputation de l'IP dépendent toujours de votre fournisseur.
Cette page ne réexplique donc pas ces enregistrements. Nous en avons une dédiée : Configuration de SPF, DKIM et DMARC pour tout ce qui envoie du courrier. Si vous n'avez pas encore décidé si vous souhaitez héberger votre propre serveur mail, commencez par notre analyse honnête sur la pertinence de l'auto-hébergement d'e-mails. Choisir Stalwart ne change rien à ce calcul.
Ce dont un petit VPS a besoin pour faire tourner un serveur mail Stalwart
La page des prérequis système de Stalwart, consultée le 27 octobre 2026, ne fournit plus de chiffre par utilisateur. Elle indique qu'un serveur inactif « reste bien en dessous » de ses limites de mémoire, et que l'utilisation du CPU dépend du volume de courriels et des connexions, et non du nombre de comptes. Le hachage des mots de passe est volontairement lent ; un serveur avec beaucoup de connexions nécessite donc plus de cœurs. Le seul exemple de dimensionnement de la page concerne un hôte avec 2 GiB de RAM, où les limites par défaut totalisent environ 2,4 GiB. Ce total inclut deux réservations de 512 MiB pour de très gros comptes, qui restent vides si vous n'en avez pas. La FAQ ajoute qu'aucun chiffre mesuré d'utilisateurs par nœud n'est publié.
Les connexions sont limitées par listener, et non par serveur. maxConnections définit par défaut 8 192 sur chaque listener sans configuration spécifique ; la limite de descripteurs de fichiers du processus doit donc couvrir plusieurs fois cette valeur. Le script d'installation l'augmente à 65536. Un service démarré autrement obtient souvent 1024, ce que la page juge trop bas pour la production.
Cette page n'indique aucune taille de disque minimale. Son benchmark a mesuré environ 0,95 GB de disque par GB de mail sur RocksDB, et a noté que les pièces jointes déjà compressées, comme les images et les PDF, peuvent nécessiter davantage. Dimensionnez le disque pour le volume de mail que vous prévoyez de conserver, avec une marge pour le compactage du stockage.
Trois chemins sortants doivent fonctionner, sinon le serveur semble défaillant pour des raisons sans rapport avec le mail. Il télécharge le bundle de l'interface web au démarrage depuis https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip. Il accède à https://acme-v02.api.letsencrypt.org/directory pour les certificats Let’s Encrypt. Il nécessite le DNS sur les ports UDP et TCP 53 pour les recherches d'enregistrements MX et d'authentification, sauf si le résolveur est configuré en DNS over HTTPS ou TLS. Les règles du filtre anti-spam ainsi que les listes IP-vers-ASN et par pays proviennent également de GitHub. Un pare-feu sortant restrictif qui bloque le premier vous donne un serveur mail fonctionnel dont les pages /admin et /account renvoient une erreur 404.
Installer une version spécifique, pas « latest »
Le script d'installation officiel est un script shell. Lisez-le avant de l'exécuter.
curl --proto '=https' --tlsv1.2 -sSf https://get.stalw.art/install.sh -o install.sh
less install.sh
sudo sh install.shLa lecture de ce script au 27 octobre 2026 montre exactement ce qu'il fait. Il crée un compte de service stalwart et les répertoires nécessaires. Il télécharge ensuite les fichiers depuis https://github.com/stalwartlabs/stalwart/releases/latest/download. Le binaire est placé dans /usr/local/bin/stalwart avec les droits 0755. La configuration va dans /etc/stalwart/config.json, les données dans /var/lib/stalwart et les journaux dans /var/log/stalwart, ces trois répertoires ayant les droits 0750 et appartenant à stalwart. Un fichier d'environnement est écrit dans /etc/stalwart/stalwart.env avec les droits 0640 et appartient à root:stalwart. Le script accepte un préfixe d'installation optionnel et un flag --fdb pour la build FoundationDB. Il ne prend aucun argument de version.
Ce dernier point est important. Le script récupère toujours la version la plus récente. Deux serveurs installés à une semaine d'intervalle exécutent la même version si aucune n'est publiée entre les installations. Le 26 octobre 2026, la version v1.0.0 est devenue la plus récente, et celle-ci a modifié la structure de la base de données. Ses notes de version indiquent que les déploiements v0.16.x existants « ne peuvent pas être mis à niveau sur place », et l'annonce de la v1.0 précise qu'un serveur v1.0 ne pourra pas ouvrir un magasin créé par une version antérieure. Au sein de la branche 1.x, la page de mise à niveau de Stalwart indique que relancer le script d'installation « remplace le binaire, conserve config.json et le fichier d'environnement, puis redémarre le service », et la FAQ recommande de sauvegarder les magasins de données et config.json avant chaque mise à niveau mineure ou majeure. La branche 0.16 a connu à elle seule sept versions correctives entre le 24 août et le 11 octobre 2026, dont plusieurs contenaient des correctifs de sécurité ; fixez donc la version la plus récente et modifiez cette contrainte volontairement.
Lors de la mise à niveau d'une installation 1.x existante vers la v1.1.0, redémarrez une fois avec STALWART_UPDATE_ROLE_PERMISSIONS=true pour ajouter les permissions introduites depuis la v1.0.0, puis supprimez la variable. La mise à niveau depuis la v1.0.0 ou v1.0.1 désactive également le chiffrement au repos par compte : sélectionnez à nouveau la clé publique de chaque compte pour le réactiver, sinon les nouveaux messages resteront en clair. Les clés enregistrées et les messages déjà chiffrés ne sont pas affectés.
STALWART_TAG=v1.1.0
curl -fsSLO "https://github.com/stalwartlabs/stalwart/releases/download/${STALWART_TAG}/stalwart-x86_64-unknown-linux-gnu.tar.gz"
tar zxf stalwart-x86_64-unknown-linux-gnu.tar.gz
sudo systemctl stop stalwart
sudo install -m 0755 -o root -g root stalwart /usr/local/bin/stalwart
sudo systemctl start stalwart
systemctl is-active stalwartsystemctl is-active stalwart doit afficher active. Pour tout autre résultat, consultez journalctl -u stalwart -n 50. L'asset de version Linux est fourni avec un bundle .sigstore.json correspondant, ce qui permet de vérifier la signature du téléchargement avant l'installation.
Si le serveur exécute déjà une version 0.16, ne remplacez pas le binaire par un binaire 1.x. Mettez d'abord à jour vers la v0.16.27, puis suivez la procédure de migration décrite dans la section sur l'importation de courriers existants ci-dessous.
L'unité que le script écrit s'exécute en tant que User=stalwart, définit AmbientCapabilities=CAP_NET_BIND_SERVICE et définit LimitNOFILE=65536. Cette capacité est la raison pour laquelle un compte sans privilèges peut lier les ports 25, 443, 465 et 993. Si vous écrivez votre propre unité plus tard et que vous omettez cette ligne, les écouteurs sur les ports privilégiés échoueront à se lier ; Stalwart ignorera ces écouteurs, démarrera les autres et journalisera un événement registry.build-error pour chaque écouteur ayant échoué. Copiez également la limite de fichiers, pour la raison indiquée dans la section des prérequis.
Où le premier mot de passe administrateur est affiché
Stalwart démarre en mode bootstrap et écrit un compte temporaire nommé admin, accompagné d'un mot de passe aléatoire de 16 caractères, dans le journal du service. Il génère un nouveau mot de passe à chaque démarrage en mode bootstrap ; seul le bloc le plus récent est donc valide.
sudo journalctl -u stalwart -n 200 | grep -A8 'bootstrap mode'L'assistant de configuration écoute en HTTP clair sur le port 8080. La page Docker de Stalwart précise qu'il n'existe aucune protection contre les attaques par force brute, n'exposez donc pas ce port. Lors d'une installation par script, bloquez le port TCP entrant 8080 dans le pare-feu de l'hôte avant la configuration ; un tunnel SSH seul ne suffit pas à fermer l'accès public. Utilisez plutôt un tunnel depuis votre ordinateur via SSH :
ssh -N -L 8080:127.0.0.1:8080 you@your-vpsOuvrez ensuite http://127.0.0.1:8080/admin et connectez-vous en tant que admin avec le mot de passe trouvé dans le journal. L'assistant demande le nom d'hôte du serveur, le domaine de messagerie par défaut, le TLS, le stockage, l'annuaire des comptes, la journalisation et la gestion DNS. Avec l'annuaire interne, le dernier écran affiche votre nouvel administrateur, admin@<domain>, ainsi qu'un mot de passe aléatoire que le serveur n'affichera ni ne journalisera à nouveau ; enregistrez-le donc à ce moment-là. Redémarrez le service une fois terminé, puis utilisez https://<your-host>/admin à partir de ce point.
Si le mot de passe n'est plus visible dans le journal, définissez-en un fixe. /etc/stalwart/stalwart.env contient des entrées commentées prévues à cet effet, notamment STALWART_RECOVERY_ADMIN=admin:changeme, STALWART_RECOVERY_MODE=true et STALWART_RECOVERY_MODE_PORT (8080 par défaut). Décommentez-les, redémarrez, connectez-vous, puis commentez-les à nouveau. La page de Stalwart sur la sécurisation du serveur avertit qu'une variable oubliée constitue « un identifiant d'accès complet permanent » ; supprimez-la donc une fois qu'un compte administrateur permanent s'est connecté. La même page recommande de n'utiliser les comptes administrateur que pour l'administration, et non comme boîtes aux lettres dans des clients IMAP, JMAP ou DAV.
En mode bootstrap, Stalwart ne démarre aucun service de messagerie et n'ouvre qu'un seul écouteur HTTP clair, sur le port 8080 par défaut. Après la configuration et un redémarrage, les écouteurs normaux démarrent sur les ports 25, 465, 993, 995, 4190, 443 et 8080. Le port 25 doit rester ouvert pour recevoir les courriels, et le port 443 est nécessaire pour la plupart des clients ainsi que pour le challenge ACME par défaut. Il est conseillé de supprimer le port 995 si aucun client n'utilise POP3, le port 4190 si personne ne gère les filtres Sieve depuis un client ManageSieve, et le port 8080 une fois la configuration terminée et le HTTPS opérationnel sur le port 443. Les ports 587, 143 et 110 n'ont pas d'écouteur actif à moins que vous n'en créiez un.
Exécution sous Docker avec un tag figé
L'image documentée est stalwartlabs/stalwart, également publiée sous le nom ghcr.io/stalwartlabs/stalwart. Au 29 octobre 2026, Docker Hub proposait v1.0.1, v1.0 et v1, chacun avec une variante -alpine. La page Docker de Stalwart recommande le tag de version majeure v1, qui suit la version 1.x la plus récente, et déconseille latest, car une future version majeure pourrait nécessiter une procédure de mise à jour différente. Figez plutôt la version de patch, pour la même raison que pour le binaire ci-dessus.
services:
stalwart:
image: stalwartlabs/stalwart:v1.1.0
container_name: stalwart
init: true
restart: unless-stopped
ports:
- "25:25"
- "465:465"
- "993:993"
- "443:443"
- "127.0.0.1:8080:8080"
volumes:
- stalwart-etc:/etc/stalwart
- stalwart-data:/var/lib/stalwart
volumes:
stalwart-etc:
stalwart-data:Ce fichier est la commande docker run documentée écrite au format Compose, avec les ports POP3S et ManageSieve omis et le port de configuration lié à localhost, comme le fait également la commande documentée. Démarrez-le et lisez la même ligne d'amorçage :
docker compose up -d
docker compose logs stalwart 2>&1 | grep -A8 'bootstrap mode'La page Docker documente également STALWART_RECOVERY_ADMIN=admin:<password> comme moyen de définir un mot de passe connu au démarrage, ce qui correspond à la clé environment: dans Compose si vous préférez cela à la lecture des journaux. Elle précise que les variables d'environnement sont figées lors de la création d'un conteneur, donc un simple redémarrage ne prend pas en compte un changement. docker compose up -d recrée le conteneur lorsque l'environnement change. Supprimez la variable après la configuration.
La liste complète des ports documentés, et pourquoi ce fichier est plus court
La page Docker de Stalwart publie les ports 25, 465, 993, 995, 4190 et 443 sur toutes les interfaces, et le 8080 uniquement sur le loopback (127.0.0.1:8080:8080). Elle ne publie pas les ports 587, 143 ou 110, qui n'ont pas d'écouteur à moins qu'un administrateur n'en crée un. Sa page sur la sécurisation du serveur indique de supprimer l'écouteur POP3S sur le port 995 lorsqu'aucun client n'utilise POP3, l'écouteur ManageSieve sur le port 4190 lorsque personne ne gère les filtres Sieve depuis un client, et l'écouteur 8080 une fois la configuration terminée et le HTTPS sur le port 443 opérationnel. N'ajoutez que ce que vos clients demandent réellement. Si un téléphone exige une soumission STARTTLS, créez un écouteur sur le port 587 puis publiez-le. Si vos utilisateurs écrivent des règles Sieve depuis un client de bureau, publiez le port 4190.
Si Compose est nouveau pour vous, notre guide Docker Compose pour un VPS couvre la structure des fichiers et le modèle de volumes nommés utilisé ici. Un avertissement qui concerne particulièrement les serveurs mail : Docker publie les ports en écrivant ses propres règles de pare-feu, et ces règles sont évaluées avant celles de ufw, donc ufw deny 8080 ne ferme pas un port publié par Compose. Avec Docker Engine 28.0.0 ou une version plus récente et la configuration par défaut du réseau bridge, lier à 127.0.0.1 dans le mappage de ports restreint l'accès à l'hôte Docker, ce qui explique pourquoi le fichier ci-dessus procède ainsi et pourquoi le tunnel SSH reste pertinent. Docker avertit que les versions antérieures à 28.0.0 permettent aux hôtes situés sur le même segment réseau L2 d'atteindre les ports publiés sur localhost ; mettez donc à jour Docker avant de vous appuyer sur cette protection.
TLS sans certbot et ce que cela implique
Stalwart implémente directement ACME (automatic certificate management environment), il n'y a donc ni certbot ni hook de renouvellement. La documentation liste quatre méthodes de validation. HTTP-01 répond à une requête de challenge sur le port 80. TLS-ALPN-01, la méthode par défaut, présente un certificat spécifique sur le port 443 en utilisant le protocole ALPN propre à ACME. DNS-01 publie des enregistrements TXT temporaires et constitue l'une des deux méthodes permettant d'émettre des certificats wildcard. DNS-PERSIST-01 utilise des enregistrements TXT d'autorisation persistants au lieu d'en écrire un nouveau à chaque renouvellement.
Le coût de cette approche est que Stalwart souhaite gérer lui-même le handshake TLS. TLS-ALPN-01 fonctionne en effectuant le handshake lui-même ; il ne peut donc pas aboutir derrière un reverse proxy qui termine le TLS pour vous. Si nginx ou Caddy occupe déjà le port 443 sur cette machine, vous disposez de trois solutions. Le guide nginx de Stalwart propose d'exécuter nginx en mode TCP passthrough, avec listen 443; proxy_pass 127.0.0.1:10443; proxy_protocol on;, afin que la connexion TLS atteigne Stalwart sans modification. Cela transfère toutes les connexions du port 443 vers Stalwart, ce qui convient à une machine où nginx ne sert aucun autre service sur ce port. Sinon, basculez Stalwart vers DNS-01 ou HTTP-01, ou attribuez-lui sa propre adresse IP.
DANE et MTA-STS : les valeurs par défaut à connaître
Ces deux mécanismes se configurent par stratégie TLS sur l'objet MtaTlsStrategy, dans l'interface web sous Settings, MTA, Outbound, TLS Strategies. Le champ dane est réglé par défaut sur optional ; il tente une validation DANE si le destinataire publie des enregistrements TLSA et bascule sur un STARTTLS classique dans le cas contraire. Réglez-le sur require pour que la distribution ne s'effectue que si un enregistrement TLSA vérifiable est présent. Le champ mtaSts se comporte de la même manière, avec optional par défaut. Les timeouts associés sont tlsTimeout (3 minutes par défaut) et mtaStsTimeout (5 minutes par défaut).
Côté réception, Stalwart peut publier votre propre politique MTA-STS sur https://mta-sts.<domain>/.well-known/mta-sts.txt, ce qui nécessite l'ouverture du port 443. Le singleton MtaSts contient mode (par défaut testing), maxAge (7 jours par défaut) et mxHosts, qui remplace les hôtes MX autorisés ; s'il est vide, il utilise les paramètres système. Vous devez fournir deux enregistrements DNS : un CNAME mta-sts pointant vers l'hôte de messagerie et un enregistrement TXT _mta-sts contenant l'identifiant de la politique.
dig +short TXT _mta-sts.example.org
curl -s https://mta-sts.example.org/.well-known/mta-sts.txtLa requête TXT doit renvoyer une chaîne v=STSv1; id=... et la commande curl doit retourner le corps de la politique. Si curl ne renvoie rien, le port 443 est fermé ou le certificat pour mta-sts.example.org n'a jamais été émis.
Laissez mode sur testing tant que ces deux vérifications ne sont pas validées. Une politique en mode enforce avec un certificat défectueux empêche les autres serveurs de vous livrer des messages, et vous en serez informé par vos utilisateurs plutôt que par les journaux. DANE présente un piège similaire : il exige que les zones DNS soient signées par DNSSEC, tant pour le domaine de messagerie que pour ses hôtes MX. De plus, les enregistrements TLSA publiés manuellement doivent rester synchronisés avec le certificat ou la clé qu'ils épinglent. Stalwart met à jour les enregistrements TLSA après un renouvellement si la gestion DNS automatique est activée et que tlsa est inclus dans le publishRecords du domaine ; il est exclu par défaut. Pour les enregistrements publiés manuellement, reuseKey permet d'éviter de modifier l'épinglage de la clé publique à chaque renouvellement, ou vous pouvez choisir d'épingler l'autorité de certification (CA) émettrice.
Le chiffrement au repos n'est pas un chiffrement de bout en bout
Chiffrement au repos
Il s'agit de la fonctionnalité la plus souvent mal interprétée ; voici donc exactement ce que dit la documentation. Le chiffrement au repos est activé par compte. Un utilisateur exporte sa clé publique depuis son client mail, colle la clé OpenPGP au format ASCII-armored ou le certificat S/MIME encodé en PEM dans le gestionnaire de compte à /account sous Account, Public Keys, puis la sélectionne dans les paramètres de chiffrement du compte. À partir de ce moment, le serveur chiffre chaque message entrant avec cette clé avant de le stocker, sous forme de message OpenPGP/MIME ou S/MIME.
L'interrupteur global atRestEnable sur le singleton Encryption est activé par défaut. Lorsqu'il est désactivé, rien n'est chiffré, quels que soient les paramètres du compte.
Le paramètre par compte encryptOnAppend est désactivé par défaut. Il étend le chiffrement aux messages ajoutés via JMAP et IMAP. Tant qu'il est désactivé, ces messages ne sont jamais chiffrés.
Dans la version 1.0.1, les messages JMAP contenant $draft et les copies créées dans le dossier Sent lors d'une soumission JMAP restent non chiffrés, même si le chiffrement à l'ajout est activé. Depuis la version 1.0.2, l'algorithme est sélectionné à partir de la clé de l'utilisateur et le choix du chiffrement par compte a été supprimé.
Protection des données au repos
Cela protège une image disque dérobée, une sauvegarde volée, ainsi qu'un opérateur qui lirait le stockage après livraison. La clé privée n'atteint jamais le serveur ; sans elle, les corps stockés sont illisibles et l'administrateur ne peut pas non plus les déchiffrer.
Cela ne protège pas le message durant son transit. Un message traverse Internet selon le chiffrement TLS négocié entre les deux serveurs, arrive en clair, et Stalwart le chiffre à ce moment précis. L'expéditeur, le fournisseur de l'expéditeur et tout nœud intermédiaire ayant supprimé le TLS ont déjà eu accès au message en clair.
Quatre limites supplémentaires doivent être énoncées clairement, et au 11 novembre 2026, la documentation les mentionne toutes. Vos dossiers Sent et Drafts sont écrits par votre client via une opération d'ajout (append), et le paramètre encryptOnAppend par compte est désactivé par défaut ; les brouillons JMAP et les copies Sent créées par une soumission JMAP restent non chiffrés lorsqu'il est activé. Le chiffrement ne couvre que le corps du message et les pièces jointes : les en-têtes tels que From, To, Subject et Date restent en texte clair, et l'enveloppe ainsi que les journaux de distribution ne sont pas affectés. Le chiffrement « n'est rétroactif dans aucun des deux sens » ; ainsi, les courriels stockés avant l'enregistrement d'une clé restent lisibles, et la désactivation du chiffrement ne déchiffre pas ce qui a été stocké lorsqu'il était actif. Enfin, une recherche dans le corps ou les pièces jointes d'un message chiffré ne donne aucun résultat, que ce soit via JMAP ou IMAP, tandis que les recherches par expéditeur, destinataire ou objet continuent de fonctionner.
L'apprentissage du spam peut conserver une copie en texte clair : le paramètre allowSpamTraining par compte, désactivé par défaut, autorise l'échantillonnage avant le chiffrement, tandis que l'apprentissage automatique à l'échelle du serveur peut conserver des échantillons indépendamment des paramètres de chiffrement du compte.
Si un utilisateur perd sa clé privée, ses e-mails sont définitivement perdus. Il n'existe aucune procédure de récupération, par conception.
Depuis la version 1.0.3, Stalwart propose également un chiffrement séparé des blobs avec des clés symétriques conservées par le serveur. Cela protège le backend de stockage des blobs, mais le serveur étant capable de les déchiffrer, cette méthode n'offre pas la même protection contre un administrateur qui lirait les courriels stockés.
WKD est une tâche de serveur web, pas de serveur mail
WKD (Web Key Directory) constitue l'autre volet de l'écosystème OpenPGP et résout un problème distinct. Il publie votre clé publique à une URL HTTPS fixe sous votre domaine, permettant au client mail de l'expéditeur de la trouver et de chiffrer le message avant même qu'il ne quitte sa machine. Il s'agit de chiffrement de bout en bout. Le chiffrement au repos de Stalwart concerne la copie stockée sur votre disque. Configurer l'un ne vous donne pas l'autre.
Stalwart ne sert pas le WKD. Ses endpoints HTTP documentés, consultés le 27 octobre 2026, listent les chemins standards pour jmap, caldav, carddav, oauth-authorization-server, openid-configuration, oauth-protected-resource, user-agent-configuration.json, autoconfig, mail-v1.xml, mta-sts.txt et acme-challenge. Il n'existe aucun chemin openpgpkey. Servez-le depuis un serveur web statique ordinaire.
La spécification définit deux structures. La méthode avancée utilise https://openpgpkey.example.org/.well-known/openpgpkey/example.org/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. La méthode directe utilise https://example.org/.well-known/openpgpkey/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Cette chaîne de 32 caractères est le SHA-1 de la partie locale en minuscules, encodée en z-base-32 ; c'est pourquoi vous ne devez jamais construire ces noms de fichiers manuellement. GnuPG les génère pour vous.
gpg --export --armor you@example.org > you.asc
gpg-wks-client --print-wkd-url you@example.org
gpg-wks-client --install-key you.asc you@example.org--print-wkd-url affiche l'URL qu'un client va interroger, en utilisant la forme sous-domaine. --install-key écrit la clé dans une arborescence de répertoires locale qui reproduit la structure WKD, sous un répertoire racine nommé openpgpkey par défaut et modifiable avec -C dir. Copiez cette arborescence dans votre racine web, ajoutez le fichier requis policy à côté du répertoire hu (un fichier vide est valide), et récupérez votre propre URL avec curl pour confirmer qu'elle renvoie bien les octets de la clé et non une erreur 404.
Stockage sur un VPS unique
Stalwart divise le stockage en quatre rôles : un data store pour les enregistrements structurés comme les comptes, la structure des boîtes mail et les paramètres, un blob store pour les octets bruts des messages et les pièces jointes, un search store pour l'indexation plein texte, et un in-memory store pour les données éphémères comme les compteurs de rate-limit, les entrées de greylisting, les verrous et les jetons. Chacun peut pointer vers un backend différent. La liste des supports inclut RocksDB, FoundationDB, PostgreSQL, MySQL et MariaDB, SQLite, le système de fichiers, le stockage objet compatible S3, Azure Blob Storage, Redis, ElasticSearch et Meilisearch.
Sur un seul VPS, la réponse est courte. La documentation qualifie RocksDB de « data store par défaut et recommandé pour les installations sur un seul nœud », et son guide de stockage précise que RocksDB, avec tous les autres stores laissés par défaut, constitue la configuration la plus simple pour un serveur unique. Redis « ne peut pas servir de data store, de blob store ou de search store ». Il sert d'in-memory store, de coordinateur de cluster ou de couche de cache ; aucun conteneur Redis séparé n'est donc requis pour démarrer. Déplacez le blob store vers S3 plus tard si les boîtes mail dépassent la capacité du disque.
Les sauvegardes dépendent du backend. La FAQ, consultée le 27 octobre 2026, indique que le serveur n'effectue aucune sauvegarde lui-même, que copier les fichiers d'un data store en cours d'exécution ne constitue pas une sauvegarde, et que l'export intégré est un dump hors ligne d'un serveur arrêté, destiné au transfert de données entre backends. Sauvegardez chaque store avec les outils propres à son backend. Avec RocksDB sur un serveur unique, le guide de stockage note que toutes les données résident dans un seul répertoire, qui est /var/lib/stalwart lors d'une installation par script. Copiez-le avec le service arrêté, ou depuis un snapshot de système de fichiers ou de volume, et conservez une copie de config.json ainsi que du fichier d'environnement avec celui-ci. Une copie au niveau fichier d'un key-value store en cours d'exécution peut le capturer en pleine écriture, et vous ne vous en rendrez compte qu'au moment de tenter une restauration.
Le filtre anti-spam qui remplace Rspamd
Le filtrage s'exécute au sein du même processus ; il n'y a donc aucun second daemon à maintenir actif. Le classifieur se configure sur le singleton SpamClassifier sous Settings, Spam Filter, Classifier. Il utilise l'algorithme FTRL-Proximal avec hachage de caractéristiques. FtrlFh est le modèle par défaut. FtrlCcfh active le hachage de caractéristiques cuckoo et est destiné aux serveurs où les collisions de hachage limitent la précision du classifieur, au prix d'une consommation accrue de mémoire et de ressources processeur par message. Il apprend à partir des messages que les utilisateurs marquent comme spam ou comme courrier légitime ; un nouveau classifieur nécessite au moins 100 échantillons de spam et 100 échantillons de ham avant son premier entraînement. Le classifieur anti-spam IA séparé, qui repose sur des modèles d'IA, est une fonctionnalité Enterprise.
Autour du classifieur se trouvent les listes de blocage DNS, le greylisting, la détection de phishing, les spam traps et Pyzor, ainsi que l'option d'appeler SpamAssassin via milter si vous avez des règles auxquelles vous refusez de renoncer.
Pourquoi mailcow reste la solution pertinente
Stalwart ne propose pas de webmail. C'est sa lacune principale, et de loin. La documentation de mailcow, consultée le 12 octobre 2026, liste seize composants dont SOGo, qui fournit nativement aux utilisateurs une interface de messagerie web ainsi qu'une interface CalDAV et CardDAV. La feuille de route de Stalwart du 20 juin 2025 indique qu'un webmail dédié est prévu mais « n'est pas une priorité immédiate », devant être développé en Rust avec Dioxus après la version 1.0, « probablement courant 2026 ». La version 1.0 a été publiée le 26 octobre 2026, et ni ses notes de version ni son annonce ne mentionnent de webmail. Au 27 octobre 2026, le blog du projet ne contient aucune annonce à ce sujet. Avec Stalwart, vous devez donc soit déployer Roundcube vous-même, soit demander à chaque utilisateur de configurer un client mail.
Stalwart dispose bien d'une interface d'administration web, ce n'est donc pas le manque attendu. Le second point concerne la jeunesse de la branche stable. Stalwart est resté en 0.x jusqu'à la publication de la v1.0.0 le 26 octobre 2026. La FAQ indique désormais que « la version 1.0 est une release stable », et l'annonce précise que le schéma est désormais stable et que les futures versions permettront une mise à jour sur place. Cette promesse a seize jours au moment de cette vérification, et chaque serveur 0.16 doit être migré plutôt que mis à jour pour l'atteindre.
Le troisième point est celui qu'on ne trouve dans aucune liste de fonctionnalités. Postfix, Dovecot et Rspamd bénéficient d'une décennie de retours d'expérience documentés. À deux heures du matin, avec des mails en file d'attente et des utilisateurs en attente, une recherche qui renvoie une chaîne d'erreur correspondante vaut plus qu'une architecture élégante. Si c'est votre situation, notre guide d'installation de mailcow couvre toute la pile de bout en bout et votre nuit sera plus courte.
Choisissez Stalwart si vous voulez un binaire unique, un fichier de configuration unique et JMAP, et que vous acceptez d'essuyer les plâtres. Choisissez mailcow si vous voulez un webmail dès aujourd'hui et une large base de connaissances existante.
Migration des e-mails existants
La méthode générique consiste à effectuer une synchronisation IMAP vers IMAP avec imapsync, qui est agnostique quant aux solutions utilisées de part et d'autre. Effectuez d'abord une simulation.
imapsync --dry \
--host1 old.example.org --user1 you@example.org --passfile1 /root/.old.pw \
--host2 mail.example.org --user2 you@example.org --passfile2 /root/.new.pw--dry permet à imapsync de « ne rien faire réellement ; il affiche simplement ce qui serait effectué ». Lisez donc cette sortie avant de retirer le flag. Chaque fichier de mot de passe contient le mot de passe sur sa première ligne, donc chmod 600 les deux et supprimez-les ensuite.
Stalwart propose également des outils plus récents que la plupart des guides tiers n'ont pas encore intégrés. Son blog documente Vandelay, un importateur et exportateur JMAP (29 mai 2026), ainsi qu'un proxy de migration pour des mises à niveau sans interruption (10 juin 2026). Lisez ces deux ressources avant de planifier une migration importante, car elles sont plus récentes que presque tout ce que vous trouverez écrit ailleurs.
Si l'ancien serveur est Stalwart 0.16 lui-même, la documentation propose désormais deux voies vers la version 1.0. L'outil stalwart-migrate ne fonctionne qu'à partir de la version v0.16.27 et copie l'intégralité du déploiement vers un nouveau stockage 1.0, avec une interruption limitée à une exécution finale pendant que chaque nœud 0.16 est arrêté. Cela nécessite de l'espace disque pour une seconde copie du magasin de données. La méthode compte par compte utilise le proxy de migration, déplaçant les comptes un par un pendant que les deux serveurs fonctionnent, au prix d'un nouveau téléchargement des données des comptes migrés par les clients. La documentation recommande stalwart-migrate pour les petits et moyens déploiements qui peuvent accepter une courte fenêtre de maintenance.
Modes d’échec et messages affichés
L’interface d’administration ne se charge jamais. La page des prérequis de Stalwart mentionne directement ce cas : le bundle de l’interface web est téléchargé depuis GitHub au démarrage et, tant que ce téléchargement n’a pas réussi, /admin et /account renvoient une erreur 404. Vérifiez depuis le serveur avec curl -sI https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip ; une redirection indique que la connexion fonctionne, tandis qu’un délai d’attente indique un blocage par votre pare-feu de sortie. La page de dépannage ajoute deux autres causes. Après la configuration, la connexion ne fonctionne qu’en HTTPS sur /admin, et HTTP simple échoue avec Unknown client id. Derrière un reverse proxy, ou sur un port HTTPS autre que 443, le serveur doit être configuré avec l’URL utilisée par les clients.
Aucun mot de passe d’amorçage dans le journal. Il est affiché à chaque démarrage tant que le serveur est en mode bootstrap, et seul le bloc le plus récent est valide. Élargissez la fenêtre avec sudo journalctl -u stalwart --since today | grep -A8 'bootstrap mode'. Si l’assistant réapparaît après sa finalisation, le fichier de configuration est absent : restaurez-le ou remontez le volume correspondant. Si vous préférez ne pas dépendre du journal, définissez STALWART_RECOVERY_ADMIN dans /etc/stalwart/stalwart.env, puis redémarrez.
Les ports privilégiés ne répondent pas après la création de votre propre unité. Sans AmbientCapabilities=CAP_NET_BIND_SERVICE, l’utilisateur stalwart ne peut pas s’attacher aux ports 25, 443, 465 ou 993. Stalwart ignore chaque listener qui échoue, démarre les autres et journalise un événement registry.build-error avec Failed to bind to <address>: <error>. Copiez la ligne de capacité depuis l’unité générée par l’installateur. Si un autre serveur de messagerie utilise le port 25, arrêtez-le et désactivez-le. L’unité de l’installateur entre en conflit avec Postfix, Sendmail et Exim ; le démarrage de l’un de ces services arrête Stalwart.
Les certificats ne sont jamais délivrés. HTTP-01 nécessite que le port 80 soit accessible et redirigé vers un listener HTTP de Stalwart. TLS-ALPN-01 nécessite que Stalwart réponde lui-même à la négociation TLS sur le port 443. Si un autre processus occupe le port requis sans rediriger la requête de validation, ACME échoue et journalise des événements acme.auth-error ou acme.order-invalid. Avec un DNS manuel, la page de dépannage exige également que mta-sts, autoconfig, autodiscover et ua-auto-config, sous votre domaine par défaut, résolvent vers le serveur, car ces noms sont inclus dans le certificat. Les échecs réseau, DNS et de validation sont automatiquement réessayés selon la politique de nouvelle tentative de la tâche ; les requêtes invalides et les challenges non pris en charge ne le sont pas.
FAQ
Stalwart remplace-t-il Postfix, Dovecot et Rspamd sur un seul VPS ?
Oui. Un seul binaire en Rust gère SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV et WebDAV, et inclut le filtre anti-spam, le stockage des messages ainsi qu'un client ACME. Il n'y a qu'une seule unité systemd et un seul fichier de configuration dans /etc/stalwart/config.json au lieu de quatre démons et de leur configuration intermédiaire. Ce qu'il ne remplace pas, c'est votre zone DNS ou la politique de votre fournisseur concernant le port 25, qui sont les éléments déterminants pour la réussite ou l'échec de l'auto-hébergement d'un serveur mail.
De combien de RAM un serveur mail Stalwart a-t-il besoin ?
Au 27 octobre 2026, la page des prérequis système de Stalwart ne donne aucun chiffre par utilisateur, et la FAQ précise qu'aucune mesure du nombre d'utilisateurs par nœud n'est publiée. La page indique qu'un serveur au repos reste bien en dessous de ses limites, et que l'utilisation du CPU dépend du volume de mails et des connexions plutôt que du nombre de comptes. Le seul exemple concret est un hôte de 2 GiB, où les limites de mémoire par défaut totalisent environ 2,4 GiB, incluant deux réservations de 512 MiB qui restent vides sauf si vous hébergez de très gros comptes. maxConnections définit par défaut 8 192 par écouteur. Aucune taille de disque minimale n'est publiée, dimensionnez donc le disque en fonction du volume de mails que vous conservez.
Passer à Stalwart améliorera-t-il ma délivrabilité d'e-mails ?
Non. La délivrabilité dépend de l'ouverture du port TCP 25 sortant sur votre VPS, du reverse DNS de votre IP, et de la configuration SPF, DKIM et DMARC sur votre domaine. Stalwart prend en charge DANE, MTA-STS et le rapport TLS SMTP, et peut publier votre politique MTA-STS pour vous, mais ces éléments régissent la sécurité du transport plutôt que la confiance qu'un réseau récepteur accorde à votre adresse. Testez le port 25 avec nc -vz -w 5 alt1.aspmx.l.google.com 25 avant d'installer quoi que ce soit.
Stalwart inclut-il un webmail ?
Pas au 27 octobre 2026. Il propose une interface d'administration web, ce qui est différent. La feuille de route du projet datée du 20 juin 2025 indique que le développement du webmail commencerait une fois la version 1.0 atteinte, construit en Rust avec Dioxus, « très probablement courant 2026 ». La version 1.0 est sortie le 26 octobre 2026 sans webmail, et le blog du projet n'en fait pas encore mention. Si vos utilisateurs ont besoin d'une boîte de réception dans leur navigateur dès maintenant, déployez Roundcube à côté ou utilisez une pile logicielle qui inclut SOGo.
Contre quoi le chiffrement au repos de Stalwart protège-t-il ?
Il chiffre les messages entrants de chaque utilisateur ayant opté pour cette option avec sa propre clé publique OpenPGP ou S/MIME avant de les écrire sur le disque. Ainsi, un disque volé, une sauvegarde dérobée ou un administrateur lisant le stockage ne peuvent pas récupérer le corps des messages. Il ne s'agit pas d'un chiffrement de bout en bout : le message arrive en clair et est chiffré à la livraison, donc chaque saut réseau précédent a pu le lire. Le paramètre encryptOnAppend par compte est désactivé par défaut ; les messages ajoutés par le client restent donc en clair à moins que le serveur n'autorise le chiffrement au repos et que le compte n'active le chiffrement à l'ajout. Dans la version 1.0.1, les brouillons JMAP et les copies des messages envoyés créés par soumission JMAP restent non chiffrés, même dans ce cas. La documentation précise que les en-têtes tels que l'expéditeur, les destinataires et l'objet restent lisibles, que les mails stockés avant l'enregistrement de la clé ne sont pas rechiffrés, et que les recherches dans le corps et les pièces jointes ne donnent rien dans les messages chiffrés. L'apprentissage anti-spam peut conserver des échantillons distincts en texte clair avant le chiffrement.