Listmonk op engem Managed VPS hosten: Är Newsletteren op Ärem Server

Wat Listmonk mécht

Listmonk verwalt Är Verdeelerlëschten an Är Newsletteren aus enger Webinterface. Et ass een eenzege Programm, a Go geschriwwen, deem säin eenzeg Ofhängegkeet PostgreSQL ass. Seng Lëschte lafen an eng Richtung: Dir schreift un Är Abonnenten, a et ass keng Diskussiounslëscht tëscht hinnen.

• D’Lëschten: Lëschten mat Single oder Double Opt-in, bis zu Millioune vun Abonnenten, an eng Segmentatioun duerch SQL-Ausdréck op hiren Attributer.
• D’Campagnen: e visuellen Editeur mat Drag-and-drop, e WYSIWYG-Editeur, Markdown, HTML oder reinen Text, a Virlagen an der Sprooch Go mat méi wéi 100 Funktiounen.
• D’Statistiken: Opmaachen, Klicken, Bounces an déi am meeschte verfollegt Linken, Campagne fir Campagne.
• D’Transaktiounsnoriichten: eng API, fir eng Noriicht no enger Virlag ze schécken, zum Beispill eng Bestellungsbestätegung. „Messengers“ als HTTP-Webhook maachen och SMS oder WhatsApp op, fir un de Service no Ärer Wiel unzeschléissen.
• D’Abonnenten: eng Säit, wou jidderee seng Preferenzen verwalt, seng Donnéeën exportéiert oder läscht.
• D’Team: präzis Rollen a Permissiounen, d’eenzeg Authentifiséierung OIDC a limitéiert API-Tokens.
• D’Medien: eng Bibliothéik vu Biller um Disk oder op engem S3-kompatiblen Späicher.

Wat d’AGPL-3.0-Lizenz erlaabt

Listmonk gëtt ënner der GNU-AGPL-Lizenz, Versioun 3 publizéiert. Dir kënnt en notzen, och an der Entreprise, an Är Campagnen wéi déi vun Äre Clienten schécken, ouni eng Lizenz ze kafen. Et bleiwen d’Käschte vum Server an déi vun Ärem Versandservice.

Den Artikel 13 setzt eng Bedingung derbäi, déi dem AGPL eegen ass: wann Dir de Programm ännert, muss Är Versioun all deenen, déi se um Distanz iwwer d’Netz notzen, kloer proposéieren, säi Quellcode gratis ze kréien. Wann Dir Kopien verdeelt, gëllen och d’Flichte vun der Lizenz fir d’Deele vum Code. Listmonk ouni Ännerung lafe ze loossen, léist dësen Artikel net aus.

Wéi eng Versioun vu Listmonk soll een installéieren?

E Punkt, deen ee virum Ufänke muss wëssen. Op GitHub bezeechent de Tag „Latest“ am Moment d’v7.0.0-beta.2 vum 10. November 2026, déi de Projet selwer als Beta presentéiert. Déi lescht stabil Versioun ass d’v6.2.0, déi Sécherheetskorrekture bei de Permissioune bréngt. Den 11. November 2026 bezeechent d’Docker-Image latest dës v6.2.0.

D’Versioun 7 ersetzt déi ganz Administratiounsinterface, ännert e puer vun hiren Adressen, mécht aus der Astellung app.from_email eng Lëscht vun Adressen a ännert Iwwersetzungsschlësselen, wat déi personaliséiert Virlage betrëfft. Liest hir Release Notes, ier Dir dohin wiesselt.

De Compose-Fichier vum Projet lancéiert bei all Start --upgrade --yes: eng nei Image migréiert d’Datebank, ouni Iech ze froen. Eng migréiert Datebank léisst sech awer net méi mat enger eelerer Versioun liesen, a zréckgoen verlaangt, eng Backup ze restauréieren. Mat engem fixen Tag, wéi v6.2.0, bleift de Versiounswiessel Är Entscheedung.

D’Installatioun mat Docker Compose

De Projet recommandéiert Docker Compose: säi Fichier start Listmonk a PostgreSQL zesummen. Op engem Server, wou Docker installéiert ass, erstellt en Dossier a luet dëse Fichier erof:

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

De Projet verlaangt, dëse Fichier un Är Ëmfeld unzepassen. Hei sinn déi eenzeg Zeilen, déi ze änneren sinn, de Rescht bleift:

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

• D’Passwuert vun der Datebank: de Fichier liwwert listmonk als Startwäert. Ännert et virum éischte Start, well d’PostgreSQL-Image dës Variabel nëmmen op engem eidelen Dossier fir d’Donnéeën liest.
• D’Image: eng präzis Versioun amplaz vun latest, aus dem Grond, dee virdru gesi gouf.
• De Port, deen op 127.0.0.1 publizéiert ass: dat ass eis Upassung. De Fichier vum Projet publizéiert de Port 9000 ouni Adressbegrenzung, a limitéiert PostgreSQL schonn op déi lokal Adress. Op déiselwecht Manéier behandelt, ass Listmonk nëmmen iwwer de Reverse Proxy z’erreechen.
• Den Hostnumm: de Fichier rit zu engem komplette Domainnumm.

Lancéiert dann d’Servicer, andeems Dir de Kont Super Admin am Viraus erstellt. Dës zwou Variabele déngen nëmmen dem éischte Start, an ouni si gëtt de Kont beim éischte Besuch vun der Interface erstallt: et ass besser, datt hie existéiert, ier Dir Är Domain opmaacht.

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

Ouni Docker: de Binär

Listmonk leeft och als eenzelt Programm, niewent Ärem eegene PostgreSQL-Server, a Versioun 12 oder méi nei, wou d’Datebank schonn erstallt ass.

1. Luet d’Archiv vun der v6.2.0 op der Versiounssäit vum Projet erof, zum Beispill listmonk_6.2.0_linux_amd64.tar.gz, andeems Dir d’Beta vermeit, déi uewen ugewise gëtt, an extrahéiert de Binär.
2. Generéiert de Konfiguratiounsfichier, a fëllt dann d’Zougäng zur Datebank an config.toml aus.
3. Installéiert d’Tabellen, a lancéiert dann Listmonk.

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

Standardméisseg lauschtert config.toml op localhost:9000, wat hannert engem Reverse Proxy passt. De Repository liwwert e Servicefichier listmonk@.service fir systemd.

D’Gréisst vum Server

De Site vum Projet nennt eng Produktiounsinstanz, déi eng Campagne vu méi wéi 7 Millioune E-Mailen schéckt, mat engem Bruchdeel vun engem Prozessorkär an enger Spëtz vu 57 MB Späicher. Hie publizéiert weder e Minimum nach eng Zuel fir PostgreSQL, deem säi Volumen mat Äre Abonnenten, Äre Opmaachen an Äre Klicke wiisst. Op engem Managed VPS beschreift eis Äre Gebrauch, a mir recommandéieren Iech déi passend Gréisst.

HTTPS an de Reverse Proxy

Är Abonnente klicken op Linken, déi op Är Instanz weisen: Ofmeldung, Bestätegung, Verfolgung vun de Klicken. Si gëtt also a HTTPS op hirer eegener Domain servéiert. Erstellt d’A- an AAAA-Enregistremer vun dësem Numm op Äre Server, wou d’Besucher op de Ports 80 an 443 ukommen. D’Dokumentatioun vu Listmonk léisst d’Wiel vum Proxy fräi, hei sinn zwou gängeg Konfiguratiounen.

Mat Caddy

Caddy kritt d’Zertifikat selwer an erneiert et:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Mat Nginx a Certbot

Nginx refuséiert standardméisseg Ufroe vu méi wéi 1 MB, mat engem Feeler 413. Fir e Fichier mat Abonnenten oder Biller z’importéieren, erhéicht dës Limit no der Gréisst vun Äre Fichieren:

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 setzt duerno d’Zertifikat vu Let’s Encrypt an d’Viruleedung op HTTPS, an erneiert d’Zertifikat dono vu sech aus:

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

Déi éischt Astellungen

Mellt Iech op https://listmonk.example.com/admin un, a mécht dann „Settings“ op:

• „General“, „Root URL“: déi ëffentlech Adress vun Ärer Instanz, ouni Schrägstrach um Enn, wéi https://listmonk.example.com. Listmonk hëlt doraus d’Linken fir d’Ofmeldung, d’Bestätegung an d’Verfolgung vun Ären E-Mailen. Säi Startwäert, http://localhost:9000, géif bei Ären Abonnente net funktionéieren.
• „General“, „Default from email“: d’Standard-Absenderadress, op Ärer Domain, amplaz vum Beispill, dat mat geliwwert gëtt.
• „Media“, „Upload path“: /listmonk/uploads, den Dossier, deen de Compose-Fichier um Server mountt.
• „General“: déi ëffentlech Abonnementssäit an den ëffentlechen Archiv sinn am Ufank aktiv. Behält se, wann Dir se braucht.
• „Security“, „Enable CAPTCHA“: am Ufank desaktivéiert, et schützt d’ëffentlecht Abonnementsformular.

Wat ëffentlech bleift, wat sech zoumaache léisst

Fir den Zougang no IP-Adress oder iwwer e Authentifizéierungs-Proxy ze filteren, deelt d’Dokumentatioun d’Routen esou op:

De Versand: Listmonk geet iwwer Är SMTP-Server

Listmonk bereet Är E-Mailen vir a taktéiert se, a vertraut se dann den SMTP-Serveren un, déi Dir ënner „Settings“, „SMTP“ deklaréiert. Hie liwwert se net selwer an d’Bréifkëschte vun Ären Abonnenten: d’Qualitéit vun der Zoustellung hänkt also vun dësem Server, vun Ärer Domain an vun Äre Lëschte of.

Fir e Massenversand wielt e spezialiséierte Versandservice: hie dréit d’Reputatioun vun Ären Zeendungen an d’Signature vun Ärer Domain, a weess, d’Bounces zeréckzemellen. Vun engem Simafri-VPS aus geet de Versand iwwer e authentifizéierte SMTP-Relais, um Port 587: hei deen vun dësem Service.

Als Orientéierung beschreift d’Dokumentatioun vu Listmonk d’Bounces vun Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint. Vergläicht se no Ärem Volumen an Äre Empfänger.

Klickt dann op „Test connection“: Listmonk schéckt eng Testnoriicht an weist de Feeler vum Server un, wann de Versand feelschleet. Dir kënnt e puer Server deklaréieren, een dovun pro Campagne wielen, oder d’Zeendunge no der Absenderadress oder -domain routen.

Den Débit

Reegelt en ënner „Settings“, „Performance“, ënner der Limit vun Ärem Service:

• „Concurrency“ an „Message rate“: d’Zuel vun de Versandfuedem, a vun de Noriichte pro Sekonn fir all eenzel. D’Startwäerter, 10 an 10, erlaben bis zu 100 Noriichte pro Sekonn.
• „Batch size“: d’Zuel vun den Abonnenten, déi bei all Duerchgang aus der Datebank gelies ginn, am Ufank 1 000, iwwer dem ugepeilten Débit ze halen. Méi héich verbraucht et méi Späicher.
• „Enable sliding window limit“: eng Obergrenz u Noriichten iwwer eng Dauer, nëtzlech, wann Äre Service pro Stonn zielt.
• „Maximum error threshold“: d’Zuel vu Feeler, vun där un eng Campagne pauséiert gëtt.

Eng Noriicht, déi feelschleet, gëtt nom Reglage „Retries“ nei probéiert, op anere Verbindunge vum Server. Wa se nach ëmmer feelschleet, notéiert Listmonk se als Feeler a geet zum nächste weider: verfollegt dës Feeler wärend enger grousser Campagne.

Zoustellbarkeet, Ofmeldung an Averständnis

D’Applikatioun selwer ze hosten léisst Iech Meeschter iwwer dës Themen, a si sinn et, déi entscheeden, ob Är E-Mailen ukommen.

SPF, DKIM an DMARC

Schéckt vun enger Adress vun Ärer Domain aus, a publizéiert an hirer DNS-Zon d’SPF- an DKIM-Enregistremer, déi Äre Versandservice Iech gëtt, mat engem DMARC-Enregistrement. Google verlaangt déi dräi vun den Absender vu méi wéi 5 000 Noriichte pro Dag op Gmail-Konten, mat enger Versanddomain, déi op SPF oder DKIM ausgeriicht ass, der Ofmeldung mat engem Klick fir d’Marketing-Noriichten, an engem Taux vu Spam-Meldungen ënner 0,30 %, am beschte ënner 0,10 %.

D’Ofmeldung

• An der Noriicht: setzt {{ UnsubscribeURL }} an de Foussbereich vun Ärer Virlag. Dëse Link féiert zur Verwaltung vun de Preferenzen an zur Ofmeldung.
• An den Header: d’Optioun „Include List-Unsubscribe header“ vun „Settings“, „Privacy“, am Ufank aktiv, erlaabt de Messagerie-Programmer, d’Ofmeldung mat engem Klick unzebidden.
• D’Donnéeën: déiselwecht Astellungssäit léisst dem Abonnent d’Recht, seng Donnéeën ze exportéieren, se ze läschen an sech op d’Spärlëscht ze setzen. Dës Optioune sinn am Ufank aktiv.

D’Averständnis vun Ären Empfänger

Listmonk wennt den Typ vun der Lëscht un, deen Dir wielt. Op enger Lëscht mat Single Opt-in kritt en Abonnent, dee ouni Bestätegung derbäigesat gouf, trotzdem Är Campagnen. Op enger Lëscht mat Double Opt-in kritt hie fir d’éischt eng Bestätegungs-E-Mail, a just déi bestätegt Abonnente kréien Är Campagnen. Dat ass d’Wiel, déi Är Reputatioun vum Versand am beschten schützt an eng kloer Spuer vum Accord behält.

D’Reegele hänken vum Land vun Ären Empfänger of. A Frankräich, zum Beispill, verlaangt d’CNIL d’virgängegt Averständnis vu Privatpersounen, duerch eng positiv Handlung wéi eng net virugekräizt Këscht, mat enger Ausnam fir Är Clienten bei ähnleche Produkter oder Servicer. Tëscht Professionnelle ka Prospektioun op dem berechtegten Interessi baséieren, wa se hiren Beruff betrëfft. A jidde Fall identifizéiert all Noriicht den Absender a bitt eng einfach Méiglechkeet, déi nächst ze refuséieren.

Schreift nëmmen u Leit, déi Är Noriichte erwaarden. Eng kaaft oder al Lëscht léisst d’Bounces an d’Spam-Meldungen eropgoen, an et ass Är Domain, déi d’Konsequenze dréit.

D’Verfolgung vun den Opmaachen an de Klicken

De Verfolgungspixel an d’Verfolgung vun de Klicken beréieren d’Privatsphär, an d’Dokumentatioun verlaangt, se am Respekt vu Reegele wéi der DSGVO ze notzen. Standardméisseg ass dës Verfolgung net mat all Abonnent verbonnen: d’Optioun „Individual subscriber tracking“ verbënnt se, an „Disable tracking“ schalt se komplett of, ënner „Settings“, „Privacy“.

D’Bounces

Weider un eng Adress ze schreiwen, déi Är Noriichte refuséiert, schued Ärer Reputatioun vum Versand. D’Verarbeitung vun de Bounces ass am Ufank desaktivéiert: aktivéiert se ënner „Settings“, „Bounces“, a wielt dann ee vun dëse Weeër.

• De Webhook vun Ärem Versandservice: aktivéiert „Enable bounce webhooks“ an d’Optioun vun Ärem Service. Listmonk kritt d’Bounces vu SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint op enger Adress wéi https://listmonk.example.com/webhooks/service/ses, wou dat lescht Wuert sech no dem Service ännert. Dës Adress muss ëffentlech bleiwen.
• Eng POP3-Bréifkëscht: Listmonk liest eng Bréifkëscht erëm, déi d’Bounces kritt, déi vun Ärer Absenderadress oder eng speziell. Hie schätzt dann den Typ vum Bounce no dem Inhalt vun der Noriicht, a behandelt dat als liicht, wat hie net erkennt.

Fir eng speziell Bréifkëscht deklaréiert se als Retouradress ënner „Settings“, „SMTP“, „Custom headers“:

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

D’Startastellunge sinn déi, déi d’Dokumentatioun fir SES gëtt, a si bilden eng gutt Basis:

PostgreSQL, déi eenzeg Ofhängegkeet

Listmonk verlaangt PostgreSQL 12 oder méi nei. De Compose-Fichier bréngt postgres:17-alpine mat, mat senge Donnéeën am Docker-Volume listmonk-data. Abonnenten, Campagnen, Virlagen, Statistiken an déi meescht Astellunge liewen do; nëmmen d’Zougäng zur Datebank an d’Adress, op déi gelauschtert gëtt, bleiwen an der Konfiguratioun.

Fir op e bestehende PostgreSQL-Server ze zielen, ännert d’Variabelen LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password an LISTMONK_db__database vum Service app.

Listmonk ass fir grouss Lëschte geduecht. Wann d’Datebank wiisst, ka si et sinn, déi d’Interface lues mécht: mat Millioune vun Abonnente kënnen d’Dashboard an d’Zieler Dosende vu Sekonnen daueren, fir sech unzeweisen. De Projet rit dann zu zwee Gesten:

• „Cache slow database queries“, ënner „Settings“, „Performance“: d’Zieler gi regelméisseg berechent, standardméisseg all Nuecht um 3 Auer.
• VACUUM ANALYZE op enger grousser Datebank, zum Beispill all Woch. De Befehl blockéiert d’Ufroen fir d’Zäit vu senger Passage, am Allgemenge e puer Sekonnen.

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

Backups an Aktualiséierungen

Zwee Elementer maachen Är Instanz aus: d’PostgreSQL-Datebank an den Dossier uploads, wann Är Biller um Disk bleiwen. pg_dump produzéiert e kohärenten Export, ouni Listmonk ze stoppen oder déi aner Zougäng zur Datebank ze blockéieren:

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

Fir ze restauréieren, stoppt Listmonk, leert d’Datebank a lued dann den Export nei. Wéi d’Dokumentatioun preziséiert, läscht dës Geste déi bestoend Datebank:

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

Aktualiséieren

1. Liest d’Notize vun der neier Versioun: Listmonk weist Iech déi nei Versiounen a senger Interface un, an e puer enthalen Sécherheetskorrekturen.
2. Exportéiert d’Datebank, wéi de Projet et virun all Aktualiséierung verlaangt.
3. Ännert den Tag vun der Image an docker-compose.yml.
4. Lancéiert d’Befeeler aus der Dokumentatioun. De Compose-Fichier migréiert d’Datebank beim Start.

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

Mam Binär stoppt Listmonk, ersetzt de Binär, lancéiert ./listmonk --upgrade, a start en dann nei. Fir op eng eelere Versioun zréckzegoen, restauréiert den Export, deen Dir virun der Aktualiséierung gemaach hutt, a setzt dann dee ale Tag erëm.

Wien mécht wat op engem Managed VPS

Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Listmonk bleift Är Software, mat senge Astellungen, Äre Lëschten an Äre Campagnen.

Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.