selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Listmonk logo

Self-host Listmonk

v7.0.0-beta.2

Newsletter and mailing list manager in a single binary

ReleaseOpen SourceAGPL-3.0
Updated3 days ago
LanguageGo
Setup difficultyModerate
Stars
24 288
Port
9000 (listmonk web app: admin dashboard, public subscription pages and APIs)
Requires
PostgreSQL
Docker
listmonk/listmonk
Install with Docker Compose
Main dashboard of the listmonk admin interfaceMailing list management screenCampaign analytics view with performance, bounces and top linksEmail template editing screenTransactional message API screenMessenger backends configuration screenQueue throughput and performance metrics view

What is Listmonk?

Listmonk alternatives

Should you self-host Listmonk?

Listmonk scores 80/100 on selfhost.directory (how scoring works) and ranks #1 of 109 in Email. It has 24 288 GitHub stars, +561 in the last 30 days.

It shipped 3 stable releases in the past year. The latest, v6.2.0, came out on 26 June 2026. New versions land roughly every 3 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Mailpit (77/100, 10 927 stars). Listmonk scores higher overall. See Listmonk vs Mailpit side by side.

Features

  • Bounce Processing
  • Campaign analytics
  • CSV subscriber import
  • Double opt-in subscriptions
  • Email open tracking
  • Email Template Editor
  • Link click tracking
  • Media Library
  • Multi-SMTP send queues
  • Newsletter campaigns
  • Non-email messaging via webhooksMessengers are registered in Settings -> Messengers and support optional BasicAuth.
  • REST API
  • Role-based Access Control
  • Subscriber segmentation
  • Transactional messaging API

Listmonk README

listmonk-logo

How to install Listmonk

Install Listmonk with Docker Compose

PostgreSQL
Environment variables
LISTMONK_app__address, LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password, LISTMONK_db__database, LISTMONK_db__ssl_mode, LISTMONK_db__max_open, LISTMONK_db__max_idle, LISTMONK_db__max_lifetime, LISTMONK_ADMIN_USER, LISTMONK_ADMIN_PASSWORD, TZ

Download the compose file to the current directory.

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

Run the services in the background.

docker compose up -d

The sample compose file also starts a postgres:17-alpine container; listmonk listens on 9000.

How to configure Listmonk

  • LISTMONK_app__addressInterface and port the app's webserver binds to (config.toml [app] address as env var).

    values: "0.0.0.0:9000"

  • LISTMONK_db__hostPostgreSQL host.

    values: db

  • LISTMONK_db__portPostgreSQL port.

    values: 5432

  • LISTMONK_db__userPostgreSQL user.

    values: listmonk

  • LISTMONK_db__passwordPostgreSQL password.

    values: listmonk

Listmonk releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Email

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…