Listmonk hosten op een Managed VPS: uw nieuwsbrieven op uw eigen server

Wat Listmonk doet

Listmonk beheert uw mailinglijsten en nieuwsbrieven vanuit een webinterface. Het is één enkel programma, geschreven in Go, waarvan PostgreSQL de enige afhankelijkheid is. De lijsten zijn eenrichtingsverkeer: u schrijft naar uw abonnees, en het is geen discussielijst tussen hen.

• De lijsten: lijsten met enkele of dubbele opt-in, tot miljoenen abonnees, en segmentatie met SQL-expressies op hun attributen.
• De campagnes: een visuele sleep-en-neerzet-editor, een WYSIWYG-editor, Markdown, HTML of platte tekst, en sjablonen in de taal Go met meer dan 100 functies.
• De statistieken: opens, klikken, bounces en meest gevolgde links, campagne per campagne.
• De transactionele berichten: een API om een bericht volgens een sjabloon te versturen, bijvoorbeeld een orderbevestiging. “Messengers” via HTTP-webhook openen ook sms of WhatsApp, aan te sluiten op de dienst van uw keuze.
• De abonnees: een pagina waar iedereen zijn voorkeuren beheert, zijn gegevens exporteert of wist.
• Het team: precieze rollen en rechten, eenmalige aanmelding met OIDC en beperkte API-tokens.
• De media: een afbeeldingenbibliotheek op schijf of op een S3-compatibele opslag.

Wat de AGPL-3.0-licentie toestaat

Listmonk wordt gepubliceerd onder de GNU AGPL-licentie, versie 3. U kunt het gebruiken, ook in een bedrijf, en uw campagnes en die van uw klanten versturen, zonder een licentie te kopen. Wat overblijft, zijn de kosten van de server en die van uw verzenddienst.

Artikel 13 voegt een voorwaarde toe die eigen is aan de AGPL: als u het programma wijzigt, moet uw versie iedereen die het op afstand, via het netwerk, gebruikt duidelijk de mogelijkheid bieden de broncode gratis te verkrijgen. Verspreidt u kopieën, dan gelden ook de verplichtingen van de licentie om de code te delen. Listmonk ongewijzigd laten draaien activeert dit artikel niet.

Welke versie van Listmonk installeert u?

Iets om te weten voordat u begint. Op GitHub wijst het label “Latest” op dit moment naar v7.0.0-beta.2 van 10 november 2026, die het project zelf een bèta noemt. De laatste stabiele versie is v6.2.0, die beveiligingsfixes voor de rechten bevat. Op 11 november 2026 wijst de Docker-image latest naar deze v6.2.0.

Versie 7 vervangt de hele beheerinterface, wijzigt enkele adressen ervan, maakt van de instelling app.from_email een lijst met adressen en wijzigt vertaalsleutels, wat aangepaste sjablonen raakt. Lees de release-opmerkingen voordat u overstapt.

Het Compose-bestand van het project voert bij elke start --upgrade --yes uit: een nieuwe image migreert de database zonder het u te vragen. Een gemigreerde database is echter niet meer te lezen met een oudere versie, en teruggaan vraagt een back-up terug te zetten. Met een vaste tag, zoals v6.2.0, blijft de overstap naar een andere versie uw beslissing.

De installatie met Docker Compose

Het project beveelt Docker Compose aan: zijn bestand start Listmonk en PostgreSQL samen. Maak op een server waar Docker is geïnstalleerd een map aan en haal dat bestand op:

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

Het project vraagt dit bestand aan uw omgeving aan te passen. Dit zijn de enige regels die u wijzigt, de rest blijft staan:

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

• Het wachtwoord van de database: het bestand levert listmonk als beginwaarde. Wijzig het vóór de eerste start, want de PostgreSQL-image leest deze variabele alleen bij een lege gegevensmap.
• De image: een bepaalde versie in plaats van latest, om de hierboven genoemde reden.
• De poort gepubliceerd op 127.0.0.1: dit is onze aanpassing. Het bestand van het project publiceert poort 9000 zonder adresbeperking, en beperkt PostgreSQL al tot het lokale adres. Op dezelfde manier behandeld is Listmonk alleen via de reverse proxy bereikbaar.
• De hostnaam: het bestand raadt een volledig gekwalificeerde domeinnaam aan.

Start daarna de diensten en maak het Super Admin-account vooraf aan. Deze twee variabelen dienen alleen bij de eerste start, en zonder hen wordt het account aangemaakt bij het eerste bezoek aan de interface: laat het liever bestaan voordat u uw domein opent.

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

Zonder Docker: het binaire bestand

Listmonk draait ook als losstaand programma, naast uw eigen PostgreSQL-server, versie 12 of nieuwer, waar de database al is aangemaakt.

1. Download het archief van v6.2.0 op de pagina met de versies van het project, bijvoorbeeld listmonk_6.2.0_linux_amd64.tar.gz, en vermijd de bèta die bovenaan staat, en pak het binaire bestand uit.
2. Genereer het configuratiebestand en vul de toegangsgegevens van de database in config.toml in.
3. Installeer de tabellen en start daarna Listmonk.

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

Standaard luistert config.toml op localhost:9000, wat past achter een reverse proxy. De repository levert een servicebestand listmonk@.service voor systemd.

De grootte van de server

De website van het project noemt een productie-instantie die een campagne van meer dan 7 miljoen e-mails verstuurt met een fractie van een processorcore en een piek van 57 MB geheugen. Het publiceert geen minimum en geen cijfer voor PostgreSQL, waarvan het volume groeit met uw abonnees, opens en klikken. Beschrijf op een managed VPS uw gebruik aan ons, dan raden wij u de passende grootte aan.

HTTPS en de reverse proxy

Uw abonnees klikken op links die naar uw instantie wijzen: uitschrijven, bevestigen, klikregistratie. Ze wordt dus via HTTPS aangeboden op een eigen domeinnaam. Maak de A- en AAAA-records van die naam naar uw server aan, waar de bezoekers binnenkomen op de poorten 80 en 443. De documentatie van Listmonk laat de keuze van de proxy vrij, hier twee gangbare configuraties.

Met Caddy

Caddy verkrijgt en vernieuwt het certificaat vanzelf:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Met Nginx en Certbot

Nginx weigert standaard verzoeken van meer dan 1 MB, met een fout 413. Om een bestand met abonnees of afbeeldingen te importeren, verhoogt u deze limiet naar de maat van uw bestanden:

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 plaatst vervolgens het Let’s Encrypt-certificaat en de doorverwijzing naar HTTPS, en vernieuwt het certificaat daarna zelf:

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

De eerste instellingen

Meld u aan op https://listmonk.example.com/admin en open daarna “Settings”:

• “General”, “Root URL”: het publieke adres van uw instantie, zonder slash aan het eind, zoals https://listmonk.example.com. Listmonk haalt daaruit de links voor uitschrijven, bevestigen en klikregistratie in uw e-mails. De beginwaarde, http://localhost:9000, zou bij uw abonnees niet werken.
• “General”, “Default from email”: het standaard afzenderadres, op uw domein, in plaats van het meegeleverde voorbeeld.
• “Media”, “Upload path”: /listmonk/uploads, de map die het Compose-bestand op de server koppelt.
• “General”: de openbare aanmeldpagina en het openbare archief zijn in het begin actief. Houd ze als u ze nodig hebt.
• “Security”, “Enable CAPTCHA”: in het begin uitgeschakeld, het beschermt het openbare aanmeldformulier.

Wat openbaar blijft, wat dicht kan

Om de toegang te filteren, op IP-adres of via een authenticatieproxy, verdeelt de documentatie de routes zo:

Het verzenden: Listmonk loopt via uw SMTP-servers

Listmonk bereidt uw e-mails voor en bepaalt het tempo, en vertrouwt ze daarna toe aan de SMTP-servers die u opgeeft in “Settings”, “SMTP”. Het levert ze niet zelf af in de mailboxen van uw abonnees: de kwaliteit van de aflevering hangt dus af van die server, van uw domein en van uw lijsten.

Kies voor massaverzending een gespecialiseerde verzenddienst: die draagt de reputatie van uw verzendingen en de handtekeningen van uw domein, en weet bounces terug te melden. Vanaf een Simafri-VPS loopt het verzenden via een geauthenticeerde SMTP-relay, op poort 587: hier die van deze dienst.

Ter oriëntatie beschrijft de documentatie van Listmonk de bounces van Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email en Lettermint. Vergelijk ze naargelang uw volume en uw ontvangers.

Klik daarna op “Test connection”: Listmonk verstuurt een testbericht en toont de fout van de server als het verzenden mislukt. U kunt meerdere servers opgeven, er per campagne een kiezen, of de verzendingen routeren naargelang het afzenderadres of -domein.

Het tempo

Stel het in onder “Settings”, “Performance”, onder de limiet van uw dienst:

• “Concurrency” en “Message rate”: het aantal verzendthreads, en berichten per seconde voor elk. De beginwaarden, 10 en 10, staan tot 100 berichten per seconde toe.
• “Batch size”: het aantal abonnees dat bij elke ronde uit de database wordt gelezen, 1.000 in het begin, boven het beoogde tempo te houden. Hoger verbruikt het meer geheugen.
• “Enable sliding window limit”: een plafond aan berichten over een periode, nuttig wanneer uw dienst per uur telt.
• “Maximum error threshold”: het aantal fouten waarboven een campagne pauzeert.

Een bericht dat mislukt, wordt opnieuw geprobeerd volgens de instelling “Retries”, op andere verbindingen van de server. Mislukt het nog steeds, dan noteert Listmonk het als fout en gaat naar het volgende: houd deze fouten in de gaten tijdens een grote campagne.

Bezorgbaarheid, uitschrijven en toestemming

De applicatie hosten laat u zelf de baas over deze onderwerpen, en zij bepalen of uw e-mails aankomen.

SPF, DKIM en DMARC

Verstuur vanaf een adres van uw domein en publiceer in de DNS-zone ervan de SPF- en DKIM-records die uw verzenddienst u geeft, met een DMARC-record. Google vraagt alle drie van afzenders van meer dan 5.000 berichten per dag naar Gmail-accounts, met een verzenddomein dat is afgestemd op SPF of DKIM, uitschrijven met één klik voor marketingberichten, en een spammeldingspercentage onder 0,30 %, idealiter onder 0,10 %.

Het uitschrijven

• In het bericht: plaats {{ UnsubscribeURL }} in de voettekst van uw sjabloon. Die link leidt naar het beheer van voorkeuren en het uitschrijven.
• In de headers: de optie “Include List-Unsubscribe header” van “Settings”, “Privacy”, in het begin actief, laat e-mailprogramma's uitschrijven met één klik voorstellen.
• De gegevens: dezelfde instellingenpagina geeft de abonnee het recht zijn gegevens te exporteren, te wissen en zich op de blokkeerlijst te zetten. Deze opties zijn in het begin actief.

De toestemming van uw ontvangers

Listmonk past het lijsttype toe dat u kiest. Op een lijst met enkele opt-in ontvangt een abonnee die zonder bevestiging is toegevoegd toch uw campagnes. Op een lijst met dubbele opt-in ontvangt hij eerst een bevestigingsmail, en alleen bevestigde abonnees ontvangen uw campagnes. Dat is de keuze die uw verzendreputatie het best beschermt en een duidelijk spoor van de toestemming bewaart.

De regels hangen af van het land van uw ontvangers. In Frankrijk bijvoorbeeld vraagt de CNIL vooraf toestemming van particulieren, via een actieve handeling zoals een niet vooraf aangevinkt vakje, met een uitzondering voor uw klanten bij soortgelijke producten of diensten. Tussen bedrijven kan prospectie berusten op gerechtvaardigd belang als ze hun beroep betreft. In alle gevallen identificeert elk bericht de afzender en biedt het een eenvoudige manier om de volgende te weigeren.

Schrijf alleen aan mensen die uw berichten verwachten. Een gekochte of oude lijst laat bounces en spammeldingen stijgen, en uw domein draagt de gevolgen.

De registratie van opens en klikken

De trackingpixel en de klikregistratie raken aan de privacy, en de documentatie vraagt ze te gebruiken met inachtneming van regels als de AVG. Standaard is deze registratie niet aan elke abonnee gekoppeld: de optie “Individual subscriber tracking” koppelt haar, en “Disable tracking” zet haar helemaal uit, in “Settings”, “Privacy”.

De bounces

Blijven schrijven naar een adres dat uw berichten afwijst, schaadt uw verzendreputatie. De verwerking van bounces is in het begin uitgeschakeld: schakel haar in onder “Settings”, “Bounces” en kies daarna een van deze twee wegen.

• De webhook van uw verzenddienst: schakel “Enable bounce webhooks” en de optie van uw dienst in. Listmonk ontvangt de bounces van SES, Azure Communication Services, SendGrid, Postmark, Forward Email en Lettermint op een adres zoals https://listmonk.example.com/webhooks/service/ses, waarbij het laatste woord per dienst verschilt. Dit adres moet openbaar blijven.
• Een POP3-mailbox: Listmonk leest een mailbox die de bounces ontvangt, die van uw afzenderadres of een eigen mailbox. Het raadt dan het type bounce aan de hand van de inhoud van het bericht, en beschouwt wat het niet herkent als licht.

Geef voor een eigen mailbox deze op als retouradres in “Settings”, “SMTP”, “Custom headers”:

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

De beginwaarden zijn die welke de documentatie voor SES geeft, en ze vormen een goede basis:

PostgreSQL, de enige afhankelijkheid

Listmonk vraagt PostgreSQL 12 of nieuwer. Het Compose-bestand brengt postgres:17-alpine mee, met de gegevens in het Docker-volume listmonk-data. Abonnees, campagnes, sjablonen, statistieken en de meeste instellingen staan daar; alleen de toegangsgegevens van de database en het luisteradres blijven in de configuratie.

Om op een bestaande PostgreSQL-server te mikken, wijzigt u de variabelen LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password en LISTMONK_db__database van de dienst app.

Listmonk is ontworpen voor grote lijsten. Naarmate de database groeit, kan zij de interface vertragen: met miljoenen abonnees kunnen het dashboard en de tellers tientallen seconden nodig hebben om te verschijnen. Het project raadt dan twee handelingen aan:

• “Cache slow database queries”, in “Settings”, “Performance”: de tellers worden met regelmatige tussenpozen berekend, standaard elke nacht om 3 uur.
• VACUUM ANALYZE op een grote database, bijvoorbeeld elke week. De opdracht blokkeert de query's tijdens haar uitvoering, doorgaans enkele seconden.

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

Back-ups en updates

Twee onderdelen vormen uw instantie: de PostgreSQL-database en de map uploads, als uw afbeeldingen op de schijf blijven. pg_dump maakt een consistente export zonder Listmonk te stoppen en zonder de andere toegang tot de database te blokkeren:

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

Om terug te zetten, stopt u Listmonk, maakt u de database leeg en laadt u de export opnieuw. Zoals de documentatie preciseert, wist deze handeling de bestaande database:

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

Bijwerken

1. Lees de opmerkingen van de nieuwe versie: Listmonk meldt nieuwe versies in zijn interface, en sommige bevatten beveiligingsfixes.
2. Exporteer de database, zoals het project vóór elke update vraagt.
3. Wijzig de tag van de image in docker-compose.yml.
4. Voer de opdrachten uit de documentatie uit. Het Compose-bestand migreert de database bij het opstarten.

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

Met het binaire bestand stopt u Listmonk, vervangt u het binaire bestand, voert u ./listmonk --upgrade uit en start u het daarna opnieuw. Om terug te keren naar een eerdere versie zet u de export terug die vóór de update is gemaakt en zet u de oude tag terug.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Listmonk blijft uw software, met zijn instellingen, uw lijsten en uw campagnes.

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.