Listmonk auf einem Managed VPS hosten: Ihre Newsletter auf Ihrem Server

Was Listmonk kann

Listmonk verwaltet Ihre Verteilerlisten und Ihre Newsletter über eine Weboberfläche. Es ist ein einzelnes, in Go geschriebenes Programm, dessen einzige Abhängigkeit PostgreSQL ist. Seine Listen sind einseitig: Sie schreiben an Ihre Abonnenten, und es handelt sich nicht um eine Diskussionsliste unter ihnen.

• Die Listen: Listen mit Single- oder Double-Opt-in, bis zu Millionen von Abonnenten, und eine Segmentierung per SQL-Ausdrücken über ihre Attribute.
• Die Kampagnen: ein visueller Drag-and-drop-Editor, ein WYSIWYG-Editor, Markdown, HTML oder reiner Text und Vorlagen in der Sprache Go mit mehr als 100 Funktionen.
• Die Statistiken: Öffnungen, Klicks, Bounces und die am häufigsten verfolgten Links, Kampagne für Kampagne.
• Die transaktionalen Nachrichten: eine API, um eine Nachricht nach einer Vorlage zu senden, zum Beispiel eine Bestellbestätigung. „Messenger“ als HTTP-Webhook öffnen außerdem SMS oder WhatsApp, anzubinden an den Dienst Ihrer Wahl.
• Die Abonnenten: eine Seite, auf der jeder seine Einstellungen verwaltet, seine Daten exportiert oder löscht.
• Das Team: präzise Rollen und Berechtigungen, die Single-Sign-on-Anmeldung per OIDC und eingeschränkte API-Tokens.
• Die Medien: eine Bildbibliothek auf der Festplatte oder auf einem S3-kompatiblen Speicher.

Was die AGPL-3.0 erlaubt

Listmonk wird unter der GNU AGPL Version 3 veröffentlicht. Sie können es nutzen, auch im Unternehmen, und Ihre Kampagnen wie die Ihrer Kunden versenden, ohne eine Lizenz zu kaufen. Bleiben die Kosten für den Server und für Ihren Versanddienst.

Artikel 13 fügt eine Bedingung hinzu, die der AGPL eigen ist: Wenn Sie das Programm ändern, muss Ihre Version allen, die es aus der Ferne über das Netzwerk nutzen, deutlich anbieten, ihren Quellcode kostenlos zu erhalten. Wenn Sie Kopien weitergeben, gelten auch die Pflichten der Lizenz zur Weitergabe des Codes. Listmonk unverändert zu betreiben, löst diesen Artikel nicht aus.

Welche Version von Listmonk sollte man installieren?

Ein Punkt, den Sie vor dem Beginn kennen sollten. Auf GitHub bezeichnet das Etikett „Latest“ derzeit die v7.0.0-beta.2 vom 10. November 2026, die das Projekt selbst als Beta darstellt. Die letzte stabile Version ist die v6.2.0, die Sicherheitskorrekturen für die Berechtigungen enthält. Am 11. November 2026 bezeichnet das Docker-Image latest diese v6.2.0.

Die Version 7 ersetzt die gesamte Administrationsoberfläche, ändert einige ihrer Adressen, macht aus der Einstellung app.from_email eine Adressliste und ändert Übersetzungsschlüssel, was benutzerdefinierte Vorlagen betrifft. Lesen Sie ihre Release Notes, bevor Sie darauf wechseln.

Die Compose-Datei des Projekts führt bei jedem Start --upgrade --yes aus: Ein neues Image migriert die Datenbank, ohne Sie zu fragen. Eine migrierte Datenbank lässt sich aber mit einer älteren Version nicht mehr lesen, und ein Zurück verlangt die Wiederherstellung eines Backups. Mit einem festen Tag wie v6.2.0 bleibt der Versionswechsel Ihre Entscheidung.

Die Installation mit Docker Compose

Das Projekt empfiehlt Docker Compose: Seine Datei startet Listmonk und PostgreSQL gemeinsam. Legen Sie auf einem Server, auf dem Docker installiert ist, einen Ordner an und holen Sie diese Datei:

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

Das Projekt verlangt, diese Datei an Ihre Umgebung anzupassen. Das sind die einzigen Zeilen, die Sie ändern, der Rest bleibt unverändert:

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

• Das Passwort der Datenbank: Die Datei liefert listmonk als Startwert. Ändern Sie es vor dem ersten Start, denn das PostgreSQL-Image liest diese Variable nur bei einem leeren Datenordner.
• Das Image: eine bestimmte Version anstelle von latest, aus dem oben genannten Grund.
• Der auf 127.0.0.1 veröffentlichte Port: Das ist unsere Anpassung. Die Datei des Projekts veröffentlicht den Port 9000 ohne Adressbegrenzung und beschränkt PostgreSQL bereits auf die lokale Adresse. Auf dieselbe Weise behandelt, ist Listmonk nur über den Reverse Proxy erreichbar.
• Der Hostname: Die Datei rät zu einem vollständigen Domainnamen.

Starten Sie dann die Dienste und legen Sie dabei das Super-Admin-Konto gleich an. Diese beiden Variablen dienen nur dem ersten Start, und ohne sie wird das Konto beim ersten Besuch der Oberfläche angelegt: Besser, es existiert, bevor Sie Ihre Domain öffnen.

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

Ohne Docker: das Binary

Listmonk läuft auch als eigenständiges Programm, neben Ihrem eigenen PostgreSQL-Server in Version 12 oder neuer, auf dem die Datenbank bereits angelegt ist.

1. Laden Sie das Archiv der v6.2.0 von der Versionsseite des Projekts herunter, zum Beispiel listmonk_6.2.0_linux_amd64.tar.gz, und meiden Sie dabei die an erster Stelle angezeigte Beta; entpacken Sie das Binary.
2. Erzeugen Sie die Konfigurationsdatei und tragen Sie dann die Zugangsdaten zur Datenbank in config.toml ein.
3. Installieren Sie die Tabellen und starten Sie dann Listmonk.

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

Standardmäßig lauscht config.toml auf localhost:9000, was hinter einem Reverse Proxy passt. Das Repository liefert eine Dienstdatei listmonk@.service für systemd.

Die Größe des Servers

Die Website des Projekts nennt eine Produktionsinstanz, die eine Kampagne von mehr als 7 Millionen E-Mails mit einem Bruchteil eines Prozessorkerns und einer Spitze von 57 MB Arbeitsspeicher versendet. Sie veröffentlicht weder ein Minimum noch eine Zahl für PostgreSQL, dessen Volumen mit Ihren Abonnenten, Ihren Öffnungen und Ihren Klicks wächst. Auf einem Managed VPS beschreiben Sie uns Ihren Einsatz, und wir empfehlen Ihnen die passende Größe.

HTTPS und der Reverse Proxy

Ihre Abonnenten klicken auf Links, die auf Ihre Instanz zeigen: Abmeldung, Bestätigung, Klickverfolgung. Sie wird daher mit HTTPS unter einem eigenen Domainnamen betrieben. Legen Sie die A- und AAAA-Einträge dieses Namens auf Ihren Server an, wo die Besucher über die Ports 80 und 443 ankommen. Die Dokumentation von Listmonk lässt die Wahl des Proxys offen, hier zwei gängige Konfigurationen.

Mit Caddy

Caddy bezieht und erneuert das Zertifikat selbstständig:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Mit Nginx und Certbot

Nginx lehnt standardmäßig Anfragen über 1 MB mit einem Fehler 413 ab. Um eine Abonnentendatei oder Bilder zu importieren, erhöhen Sie dieses Limit passend zu Ihren Dateien:

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 richtet anschließend das Zertifikat von Let’s Encrypt und die Weiterleitung auf HTTPS ein und erneuert das Zertifikat danach selbstständig:

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

Die ersten Einstellungen

Melden Sie sich auf https://listmonk.example.com/admin an und öffnen Sie dann „Settings“:

• „General“, „Root URL“: die öffentliche Adresse Ihrer Instanz, ohne abschließenden Schrägstrich, etwa https://listmonk.example.com. Listmonk bildet daraus die Links zur Abmeldung, Bestätigung und Verfolgung in Ihren E-Mails. Ihr Startwert, http://localhost:9000, würde bei Ihren Abonnenten nicht funktionieren.
• „General“, „Default from email“: die Standard-Absenderadresse, auf Ihrer Domain, anstelle des mitgelieferten Beispiels.
• „Media“, „Upload path“: /listmonk/uploads, der Ordner, den die Compose-Datei auf dem Server einbindet.
• „General“: Die öffentliche Anmeldeseite und das öffentliche Archiv sind zu Beginn aktiv. Behalten Sie sie, wenn Sie sie brauchen.
• „Security“, „Enable CAPTCHA“: zu Beginn deaktiviert, schützt es das öffentliche Anmeldeformular.

Was öffentlich bleibt und was sich schließen lässt

Um den Zugang zu filtern, nach IP-Adresse oder über einen Authentifizierungs-Proxy, teilt die Dokumentation die Routen so ein:

Der Versand: Listmonk nutzt Ihre SMTP-Server

Listmonk bereitet Ihre E-Mails vor und taktet sie, dann übergibt es sie den SMTP-Servern, die Sie unter „Settings“, „SMTP“ deklarieren. Es liefert sie nicht selbst an die Postfächer Ihrer Abonnenten aus: Die Qualität der Zustellung hängt also von diesem Server, Ihrer Domain und Ihren Listen ab.

Wählen Sie für den Massenversand einen spezialisierten Versanddienst: Er trägt die Reputation Ihrer Sendungen und die Signaturen Ihrer Domain und kann Bounces zurückmelden. Von einem Simafri-VPS aus läuft der Versand über ein authentifiziertes SMTP-Relay auf Port 587: hier das dieses Dienstes.

Zur Orientierung: Die Dokumentation von Listmonk beschreibt die Bounces von Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email und Lettermint. Vergleichen Sie sie nach Ihrem Volumen und Ihren Empfängern.

Klicken Sie dann auf „Test connection“: Listmonk sendet eine Testnachricht und zeigt den Fehler des Servers an, falls der Versand scheitert. Sie können mehrere Server deklarieren, pro Kampagne einen davon wählen oder die Sendungen nach Absenderadresse oder -domain leiten.

Der Durchsatz

Stellen Sie ihn unter „Settings“, „Performance“ ein, unterhalb des Limits Ihres Dienstes:

• „Concurrency“ und „Message rate“: die Zahl der Versandthreads und der Nachrichten pro Sekunde für jeden. Die Startwerte, 10 und 10, erlauben bis zu 100 Nachrichten pro Sekunde.
• „Batch size“: die Zahl der Abonnenten, die bei jedem Durchgang aus der Datenbank gelesen werden, zu Beginn 1.000, über dem angestrebten Durchsatz zu halten. Höher verbraucht sie mehr Arbeitsspeicher.
• „Enable sliding window limit“: eine Obergrenze für Nachrichten in einem Zeitraum, nützlich, wenn Ihr Dienst pro Stunde zählt.
• „Maximum error threshold“: die Zahl der Fehler, ab der eine Kampagne pausiert.

Eine fehlgeschlagene Nachricht wird gemäß der Einstellung „Retries“ über andere Verbindungen des Servers erneut versucht. Scheitert sie weiter, vermerkt Listmonk sie als Fehler und geht zur nächsten über: Beobachten Sie diese Fehler während einer großen Kampagne.

Zustellbarkeit, Abmeldung und Einwilligung

Die Anwendung selbst zu hosten, macht Sie zum Herrn über diese Themen, und sie entscheiden, ob Ihre E-Mails ankommen.

SPF, DKIM und DMARC

Senden Sie von einer Adresse Ihrer Domain und veröffentlichen Sie in deren DNS-Zone die SPF- und DKIM-Einträge, die Ihr Versanddienst Ihnen gibt, dazu einen DMARC-Eintrag. Google verlangt alle drei von Absendern von mehr als 5.000 Nachrichten pro Tag an Gmail-Konten, mit einer an SPF oder DKIM ausgerichteten Absenderdomain, der Ein-Klick-Abmeldung für Marketing-Nachrichten und einer Spam-Meldequote unter 0,30 %, idealerweise unter 0,10 %.

Die Abmeldung

• In der Nachricht: Setzen Sie {{ UnsubscribeURL }} in den Fußbereich Ihrer Vorlage. Dieser Link führt zur Verwaltung der Einstellungen und zur Abmeldung.
• In den Headern: Die Option „Include List-Unsubscribe header“ unter „Settings“, „Privacy“, zu Beginn aktiv, erlaubt es E-Mail-Programmen, die Ein-Klick-Abmeldung anzubieten.
• Die Daten: Dieselbe Einstellungsseite lässt dem Abonnenten das Recht, seine Daten zu exportieren, zu löschen und sich auf die Sperrliste setzen zu lassen. Diese Optionen sind zu Beginn aktiv.

Die Einwilligung Ihrer Empfänger

Listmonk wendet den Listentyp an, den Sie wählen. Auf einer Liste mit Single-Opt-in erhält ein ohne Bestätigung hinzugefügter Abonnent Ihre Kampagnen trotzdem. Auf einer Liste mit Double-Opt-in erhält er zuerst eine Bestätigungs-E-Mail, und nur bestätigte Abonnenten erhalten Ihre Kampagnen. Das ist die Wahl, die Ihre Versandreputation am besten schützt und eine klare Spur der Zustimmung bewahrt.

Die Regeln hängen vom Land Ihrer Empfänger ab. In Frankreich zum Beispiel verlangt die CNIL die vorherige Einwilligung von Privatpersonen, durch eine positive Handlung wie ein nicht vorausgewähltes Kästchen, mit einer Ausnahme für Ihre Kunden bei ähnlichen Produkten oder Dienstleistungen. Zwischen Unternehmen kann sich die Ansprache auf das berechtigte Interesse stützen, wenn sie ihr Berufsfeld betrifft. In jedem Fall nennt jede Nachricht den Absender und bietet eine einfache Möglichkeit, weitere abzulehnen.

Schreiben Sie nur an Personen, die Ihre Nachrichten erwarten. Eine gekaufte oder alte Liste lässt die Bounces und Spam-Meldungen steigen, und die Folgen trägt Ihre Domain.

Die Verfolgung von Öffnungen und Klicks

Das Tracking-Pixel und die Klickverfolgung berühren die Privatsphäre, und die Dokumentation verlangt, sie im Einklang mit Regeln wie der DSGVO zu nutzen. Standardmäßig wird diese Verfolgung nicht mit jedem Abonnenten verknüpft: Die Option „Individual subscriber tracking“ verknüpft sie, und „Disable tracking“ schaltet sie ganz ab, unter „Settings“, „Privacy“.

Die Bounces

Weiter an eine Adresse zu schreiben, die Ihre Nachrichten zurückweist, schadet Ihrer Versandreputation. Die Verarbeitung der Bounces ist zu Beginn deaktiviert: Aktivieren Sie sie unter „Settings“, „Bounces“ und wählen Sie dann einen dieser beiden Wege.

• Der Webhook Ihres Versanddienstes: Aktivieren Sie „Enable bounce webhooks“ und die Option Ihres Dienstes. Listmonk erhält die Bounces von SES, Azure Communication Services, SendGrid, Postmark, Forward Email und Lettermint auf einer Adresse wie https://listmonk.example.com/webhooks/service/ses, wobei sich das letzte Wort je nach Dienst ändert. Diese Adresse muss öffentlich bleiben.
• Ein POP3-Postfach: Listmonk liest ein Postfach aus, das die Bounces empfängt, das Ihrer Absenderadresse oder ein eigenes. Es errät dann die Art des Bounces anhand des Nachrichteninhalts und behandelt als leicht, was es nicht erkennt.

Für ein eigenes Postfach deklarieren Sie es als Rückadresse unter „Settings“, „SMTP“, „Custom headers“:

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

Die Startwerte sind die, die die Dokumentation für SES angibt, und sie bilden eine gute Basis:

PostgreSQL, die einzige Abhängigkeit

Listmonk verlangt PostgreSQL 12 oder neuer. Die Compose-Datei bringt postgres:17-alpine mit, mit seinen Daten im Docker-Volume listmonk-data. Abonnenten, Kampagnen, Vorlagen, Statistiken und die meisten Einstellungen leben dort; nur die Zugangsdaten zur Datenbank und die Lauschadresse bleiben in der Konfiguration.

Um einen bestehenden PostgreSQL-Server anzusprechen, ändern Sie die Variablen LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password und LISTMONK_db__database des Dienstes app.

Listmonk ist für große Listen gemacht. Wächst die Datenbank, kann sie es sein, die die Oberfläche bremst: Bei Millionen von Abonnenten können das Dashboard und die Zähler Dutzende von Sekunden zum Anzeigen brauchen. Das Projekt rät dann zu zwei Maßnahmen:

• „Cache slow database queries“, unter „Settings“, „Performance“: Die Zähler werden in regelmäßigen Abständen berechnet, standardmäßig jede Nacht um 3 Uhr.
• VACUUM ANALYZE auf einer großen Datenbank, zum Beispiel jede Woche. Der Befehl blockiert die Abfragen für die Dauer seines Durchlaufs, in der Regel einige Sekunden.

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

Backups und Updates

Zwei Elemente machen Ihre Instanz aus: die PostgreSQL-Datenbank und der Ordner uploads, falls Ihre Bilder auf der Festplatte bleiben. pg_dump erzeugt einen konsistenten Export, ohne Listmonk anzuhalten oder die anderen Zugriffe auf die Datenbank zu blockieren:

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

Zum Wiederherstellen stoppen Sie Listmonk, leeren die Datenbank und laden dann den Export neu. Wie die Dokumentation klarstellt, löscht dieser Schritt die vorhandene Datenbank:

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

Aktualisieren

1. Lesen Sie die Release Notes der neuen Version: Listmonk weist in seiner Oberfläche auf neue Versionen hin, und manche enthalten Sicherheitskorrekturen.
2. Exportieren Sie die Datenbank, wie es das Projekt vor jedem Update verlangt.
3. Ändern Sie das Tag des Images in der docker-compose.yml.
4. Führen Sie die Befehle aus der Dokumentation aus. Die Compose-Datei migriert die Datenbank beim Start.

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

Mit dem Binary stoppen Sie Listmonk, ersetzen das Binary, führen ./listmonk --upgrade aus und starten es dann neu. Um zu einer früheren Version zurückzukehren, stellen Sie den vor dem Update gezogenen Export wieder her und setzen dann das alte Tag zurück.

Wer was tut auf einem Managed VPS

Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Listmonk bleibt Ihre Software, mit ihren Einstellungen, Ihren Listen und Ihren Kampagnen.

Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.