Héberger Listmonk sur un VPS infogéré : vos newsletters sur votre serveur

Ce que fait Listmonk

Listmonk gère vos listes de diffusion et vos newsletters depuis une interface web. C'est un programme unique, écrit en Go, dont PostgreSQL est la seule dépendance. Ses listes sont à sens unique : vous écrivez à vos abonnés, et il ne s'agit pas d'une liste de discussion entre eux.

• Les listes : des listes en simple ou en double opt-in, jusqu’à des millions d’abonnés, et une segmentation par expressions SQL sur leurs attributs.
• Les campagnes : un éditeur visuel par glisser-déposer, un éditeur WYSIWYG, Markdown, HTML ou texte brut, et des modèles en langage Go avec plus de 100 fonctions.
• Les statistiques : ouvertures, clics, rebonds et liens les plus suivis, campagne par campagne.
• Les messages transactionnels : une API pour envoyer un message d’après un modèle, par exemple une confirmation de commande. Des « messengers » en webhook HTTP ouvrent aussi le SMS ou WhatsApp, à brancher sur le service de votre choix.
• Les abonnés : une page où chacun gère ses préférences, exporte ses données ou les efface.
• L’équipe : des rôles et permissions précis, l’authentification unique OIDC et des jetons d’API limités.
• Les médias : une bibliothèque d’images sur le disque ou sur un stockage compatible S3.

Ce que permet la licence AGPL-3.0

Listmonk est publié sous licence GNU AGPL version 3. Vous pouvez l'utiliser, y compris en entreprise, et envoyer vos campagnes comme celles de vos clients, sans licence à acheter. Reste le coût du serveur et celui de votre service d'envoi.

L'article 13 ajoute une condition propre à l'AGPL : si vous modifiez le programme, votre version doit proposer clairement à tous ceux qui s'en servent à distance, par le réseau, d'obtenir son code source, gratuitement. Si vous distribuez des copies, les obligations de partage du code de la licence s'appliquent aussi. Faire tourner Listmonk sans le modifier ne déclenche pas cet article.

Quelle version de Listmonk installer ?

Un point à connaître avant de commencer. Sur GitHub, l'étiquette « Latest » désigne en ce moment la v7.0.0-beta.2 du 10 novembre 2026, que le projet présente lui-même comme une bêta. La dernière version stable est la v6.2.0, qui porte des correctifs de sécurité sur les permissions. Au 11 novembre 2026, l'image Docker latest désigne cette v6.2.0.

La version 7 remplace toute l'interface d'administration, change certaines de ses adresses, fait du réglage app.from_email une liste d'adresses et modifie des clés de traduction, ce qui touche les modèles personnalisés. Lisez ses notes de version avant d'y passer.

Le fichier Compose du projet lance --upgrade --yes à chaque démarrage : une nouvelle image migre la base sans vous demander. Or une base migrée ne se relit pas avec une version plus ancienne, et revenir en arrière impose de restaurer une sauvegarde. Avec une étiquette fixe, comme v6.2.0, le changement de version reste votre décision.

L'installation avec Docker Compose

Le projet recommande Docker Compose : son fichier lance Listmonk et PostgreSQL ensemble. Sur un serveur où Docker est installé, créez un dossier et récupérez ce fichier :

mkdir listmonk
cd listmonk
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml

Le projet demande d'adapter ce fichier à votre environnement. Voici les seules lignes à changer, le reste ne bouge pas :

x-db-credentials: &db-credentials
  POSTGRES_USER: &db-user listmonk
  POSTGRES_PASSWORD: &db-password un-mot-de-passe-long
  POSTGRES_DB: &db-name listmonk

services:
  app:
    image: listmonk/listmonk:v6.2.0
    ports:
      - "127.0.0.1:9000:9000"
    hostname: listmonk.example.com

• Le mot de passe de la base : le fichier fournit listmonk comme valeur de départ. Changez-le avant le premier lancement, car l'image PostgreSQL ne lit cette variable que sur un dossier de données vide.
• L’image : une version précise à la place de latest, pour la raison vue plus haut.
• Le port publié sur 127.0.0.1 : c'est notre adaptation. Le fichier du projet publie le port 9000 sans limite d'adresse, et limite déjà PostgreSQL à l'adresse locale. Traité de la même façon, Listmonk s'atteint par le seul proxy inverse.
• Le nom d’hôte : le fichier conseille un nom de domaine complet.

Lancez ensuite les services, en créant le compte Super Admin d'avance. Ces deux variables ne servent qu'au premier lancement, et sans elles le compte se crée à la première visite de l'interface : autant qu'il existe avant d'ouvrir votre domaine.

LISTMONK_ADMIN_USER=votre-identifiant LISTMONK_ADMIN_PASSWORD=votre-mot-de-passe docker compose up -d

Sans Docker : le binaire

Listmonk tourne aussi en programme seul, à côté de votre propre serveur PostgreSQL, en version 12 ou plus, où la base est déjà créée.

1. Téléchargez l'archive de la v6.2.0 sur la page des versions du projet, par exemple listmonk_6.2.0_linux_amd64.tar.gz, en évitant la bêta affichée en tête, et extrayez le binaire.
2. Générez le fichier de configuration, puis renseignez les accès à la base dans config.toml.
3. Installez les tables, puis lancez Listmonk.

./listmonk --new-config
./listmonk --install
./listmonk

Par défaut, config.toml écoute sur localhost:9000, ce qui convient derrière un proxy inverse. Le dépôt fournit un fichier de service listmonk@.service pour systemd.

La taille du serveur

Le site du projet cite une instance de production qui envoie une campagne de plus de 7 millions d'e-mails avec une fraction d'un cœur de processeur et un pic de 57 Mo de mémoire. Il ne publie ni minimum ni chiffre pour PostgreSQL, dont le volume grandit avec vos abonnés, vos ouvertures et vos clics. Sur un VPS infogéré, décrivez-nous votre usage et nous vous recommandons la taille qui convient.

HTTPS et le proxy inverse

Vos abonnés cliquent sur des liens qui pointent vers votre instance : désinscription, confirmation, suivi des clics. Elle se sert donc en HTTPS sur son propre nom de domaine. Créez les enregistrements A et AAAA de ce nom vers votre serveur, où les visiteurs arrivent sur les ports 80 et 443. La documentation de Listmonk laisse le choix du proxy, voici deux configurations courantes.

Avec Caddy

Caddy obtient et renouvelle seul le certificat :

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Avec Nginx et Certbot

Nginx refuse par défaut les requêtes de plus de 1 Mo, avec une erreur 413. Pour importer un fichier d'abonnés ou des images, relevez cette limite à la mesure de vos fichiers :

server {
    listen 80;
    listen [::]:80;
    server_name listmonk.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Certbot pose ensuite le certificat Let’s Encrypt et la redirection vers HTTPS, puis renouvelle le certificat de lui-même :

sudo certbot --nginx -d listmonk.example.com

Les premiers réglages

Connectez-vous sur https://listmonk.example.com/admin, puis ouvrez « Settings » :

• « General », « Root URL » : l'adresse publique de votre instance, sans barre finale, comme https://listmonk.example.com. Listmonk en tire les liens de désinscription, de confirmation et de suivi de vos e-mails. Sa valeur de départ, http://localhost:9000, ne fonctionnerait pas chez vos abonnés.
• « General », « Default from email » : l’adresse d’expédition par défaut, sur votre domaine, à la place de l’exemple fourni.
• « Media », « Upload path » : /listmonk/uploads, le dossier que le fichier Compose monte sur le serveur.
• « General » : la page publique d’abonnement et l’archive publique sont actives au départ. Gardez-les si vous en avez l’usage.
• « Security », « Enable CAPTCHA » : désactivé au départ, il protège le formulaire public d’abonnement.

Ce qui reste public, ce qui peut se fermer

Pour filtrer l'accès, par adresse IP ou par un proxy d'authentification, la documentation partage ainsi les routes :

L'envoi : Listmonk passe par vos serveurs SMTP

Listmonk prépare et cadence vos e-mails, puis les confie aux serveurs SMTP que vous déclarez dans « Settings », « SMTP ». Il ne les livre pas lui-même aux boîtes de vos abonnés : la qualité de la livraison dépend donc de ce serveur, de votre domaine et de vos listes.

Pour un envoi en nombre, choisissez un service d'envoi spécialisé : il porte la réputation de vos envois et les signatures de votre domaine, et sait remonter les rebonds. Depuis un VPS Simafri, l'envoi passe par un relais SMTP authentifié, sur le port 587 : ici, celui de ce service.

Pour vous repérer, la documentation de Listmonk décrit les rebonds d'Amazon SES, d'Azure Communication Services, de SendGrid, de Postmark, de Forward Email et de Lettermint. Comparez-les selon votre volume et vos destinataires.

Cliquez ensuite sur « Test connection » : Listmonk envoie un message d'essai et affiche l'erreur du serveur si l'envoi échoue. Vous pouvez déclarer plusieurs serveurs, choisir l'un d'eux par campagne, ou router les envois selon l'adresse ou le domaine d'expédition.

Le débit

Réglez-le dans « Settings », « Performance », sous la limite de votre service :

• « Concurrency » et « Message rate » : le nombre de fils d’envoi, et de messages par seconde pour chacun. Les valeurs de départ, 10 et 10, autorisent jusqu’à 100 messages par seconde.
• « Batch size » : le nombre d’abonnés lus en base à chaque passage, 1 000 au départ, à garder au-dessus du débit visé. Plus haut, il consomme plus de mémoire.
• « Enable sliding window limit » : un plafond de messages sur une durée, utile quand votre service compte à l’heure.
• « Maximum error threshold » : le nombre d’erreurs au-delà duquel une campagne se met en pause.

Un message qui échoue est retenté selon le réglage « Retries », sur d'autres connexions du serveur. S'il échoue encore, Listmonk le note en erreur et passe au suivant : surveillez ces erreurs pendant une grosse campagne.

Délivrabilité, désinscription et consentement

Héberger l'application vous laisse maître de ces sujets, et ce sont eux qui décident si vos e-mails arrivent.

SPF, DKIM et DMARC

Envoyez depuis une adresse de votre domaine, et publiez dans sa zone DNS les enregistrements SPF et DKIM que votre service d'envoi vous donne, avec un enregistrement DMARC. Google demande les trois aux expéditeurs de plus de 5 000 messages par jour vers des comptes Gmail, avec un domaine d'expédition aligné sur SPF ou DKIM, la désinscription en un clic pour les messages marketing, et un taux de signalement en spam sous 0,30 %, idéalement sous 0,10 %.

La désinscription

• Dans le message : placez {{ UnsubscribeURL }} dans le pied de votre modèle. Ce lien mène à la gestion des préférences et à la désinscription.
• Dans les en-têtes : l'option « Include List-Unsubscribe header » de « Settings », « Privacy », active au départ, permet aux logiciels de messagerie de proposer la désinscription en un clic.
• Les données : la même page réglages laisse à l’abonné le droit d’exporter ses données, de les effacer et de se mettre en liste de blocage. Ces options sont actives au départ.

Le consentement de vos destinataires

Listmonk applique le type de liste que vous choisissez. Sur une liste en simple opt-in, un abonné ajouté sans confirmation reçoit quand même vos campagnes. Sur une liste en double opt-in, il reçoit d'abord un e-mail de confirmation, et seuls les abonnés confirmés reçoivent vos campagnes. C'est le choix qui protège le mieux votre réputation d'envoi et qui garde une trace claire de l'accord.

Les règles dépendent du pays de vos destinataires. En France, par exemple, la CNIL demande le consentement préalable des particuliers, par une action positive comme une case non pré-cochée, avec une exception pour vos clients sur des produits ou services similaires. Entre professionnels, la prospection peut reposer sur l'intérêt légitime si elle concerne leur métier. Dans tous les cas, chaque message identifie l'expéditeur et offre un moyen simple de refuser les suivants.

Écrivez seulement à des personnes qui attendent vos messages. Une liste achetée ou ancienne fait monter les rebonds et les signalements en spam, et c'est votre domaine qui en porte les conséquences.

Le suivi des ouvertures et des clics

Le pixel de suivi et le suivi des clics touchent à la vie privée, et la documentation demande de les utiliser dans le respect de règles comme le RGPD. Par défaut, ce suivi n'est pas relié à chaque abonné : l'option « Individual subscriber tracking » le relie, et « Disable tracking » le coupe entièrement, dans « Settings », « Privacy ».

Les rebonds

Continuer d'écrire à une adresse qui rejette vos messages abîme votre réputation d'envoi. Le traitement des rebonds est désactivé au départ : activez-le dans « Settings », « Bounces », puis choisissez l'une de ces deux voies.

• Le webhook de votre service d'envoi : activez « Enable bounce webhooks » et l'option de votre service. Listmonk reçoit les rebonds de SES, Azure Communication Services, SendGrid, Postmark, Forward Email et Lettermint sur une adresse comme https://listmonk.example.com/webhooks/service/ses, le dernier mot changeant selon le service. Cette adresse doit rester publique.
• Une boîte POP3 : Listmonk relit une boîte qui reçoit les rebonds, celle de votre adresse d'expédition ou une boîte dédiée. Il devine alors le type de rebond d'après le contenu du message, et considère comme léger ce qu'il ne reconnaît pas.

Pour une boîte dédiée, déclarez-la comme adresse de retour dans « Settings », « SMTP », « Custom headers » :

[
  {"Return-Path": "your-bounce-inbox@example.com"}
]

Les réglages de départ sont ceux que la documentation donne pour SES, et ils forment une bonne base :

PostgreSQL, la seule dépendance

Listmonk demande PostgreSQL 12 ou plus. Le fichier Compose apporte postgres:17-alpine, avec ses données dans le volume Docker listmonk-data. Abonnés, campagnes, modèles, statistiques et la plupart des réglages y vivent ; seuls les accès à la base et l'adresse d'écoute restent dans la configuration.

Pour viser un serveur PostgreSQL existant, modifiez les variables LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password et LISTMONK_db__database du service app.

Listmonk est conçu pour de grandes listes. À mesure que la base grandit, c'est elle qui peut ralentir l'interface : avec des millions d'abonnés, le tableau de bord et les compteurs peuvent mettre des dizaines de secondes à s'afficher. Le projet conseille alors deux gestes :

• « Cache slow database queries », dans « Settings », « Performance » : les compteurs se calculent à intervalle régulier, chaque nuit à 3 h par défaut.
• VACUUM ANALYZE sur une grande base, par exemple chaque semaine. La commande bloque les requêtes le temps de son passage, en général quelques secondes.

docker compose exec db psql -U listmonk -d listmonk -c 'VACUUM ANALYZE;'

Sauvegardes et mises à jour

Deux éléments font votre instance : la base PostgreSQL et le dossier uploads, si vos images restent sur le disque. pg_dump produit un export cohérent sans arrêter Listmonk ni bloquer les autres accès à la base :

docker compose exec -T db pg_dump -U listmonk listmonk > listmonk-$(date +%F).sql
tar -czf listmonk-uploads-$(date +%F).tar.gz uploads

Pour restaurer, arrêtez Listmonk, videz la base puis rechargez l'export. Comme le précise la documentation, ce geste efface la base en place :

docker compose stop app
docker compose exec db psql -U listmonk -d listmonk -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;'
docker compose exec -T db psql -U listmonk -d listmonk < listmonk-2026-11-01.sql
docker compose start app

Mettre à jour

1. Lisez les notes de la nouvelle version : Listmonk vous signale les nouvelles versions dans son interface, et certaines portent des correctifs de sécurité.
2. Exportez la base, comme le demande le projet avant toute mise à jour.
3. Changez l’étiquette de l’image dans docker-compose.yml.
4. Lancez les commandes de la documentation. Le fichier Compose migre la base au démarrage.

docker compose down app
docker compose pull
docker compose up app -d

Avec le binaire, arrêtez Listmonk, remplacez le binaire, lancez ./listmonk --upgrade, puis relancez-le. Pour revenir à une version antérieure, restaurez l'export pris avant la mise à jour, puis remettez l'ancienne étiquette.

Qui fait quoi sur un VPS infogéré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Listmonk reste votre logiciel, avec ses réglages, vos listes et vos campagnes.

Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.