Repolode
knadh

knadh/listmonk

Self-hosted newsletter and mailing list manager shipped as a single Go binary, backed by PostgreSQL.

Open-source alternative to:MailchimpSubstack

Stars
23,866
Forks
2,702
Open issues
61
Last commit
7 hours ago

What is it?

listmonk is a standalone, self-hosted newsletter and mailing list manager. It runs as a single binary and uses PostgreSQL as its data store, and it includes a modern web dashboard for managing subscribers, lists and campaigns.

Installation is available via Docker Compose or by downloading a release binary, which is set up with a generated config file and commands to initialize or upgrade the database. The backend is written in Go and the frontend uses Vue with Buefy.

The project is licensed under AGPL-3.0 and is aimed at teams that want to run their own mailing list and campaign infrastructure instead of relying on a hosted email marketing service.

Key features

  • 01Ships as a single binary with PostgreSQL as the database.
  • 02Provides a web dashboard for managing subscribers, lists and campaigns.
  • 03Deploys via Docker Compose or from prebuilt release binaries.
  • 04Database install and upgrade are handled by built-in commands.
  • 05Supports SMTP and transactional email sending, plus an SMS gateway topic.

Use cases

  • Running a self-hosted newsletter for a community or publication.
  • Managing opt-in mailing lists without a third-party email marketing platform.
  • Sending transactional emails through your own SMTP server.

Quick start

  1. 1

    Download the compose file

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

    Start the services in the background

    docker compose up -d
  3. 3

    Open the app in your browser at localhost port 9000

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing source changes when offered over a network.
  • Requires a PostgreSQL database as its data store.

Topics

FAQ

What is listmonk?
Self-hosted newsletter and mailing list manager shipped as a single Go binary, backed by PostgreSQL. listmonk is a standalone, self-hosted newsletter and mailing list manager. It runs as a single binary and uses PostgreSQL as its data store, and it includes a modern web dashboard for managing subscribers, lists and campaigns.
Is listmonk free to use? What license does it have?
listmonk is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is listmonk still maintained?
Actively maintained. The last commit to listmonk was on Oct 20, 2026.
What can I use listmonk for?
Running a self-hosted newsletter for a community or publication. Managing opt-in mailing lists without a third-party email marketing platform. Sending transactional emails through your own SMTP server.
How do I install listmonk?
Download the compose file: curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml Start the services in the background: docker compose up -d Open the app in your browser at localhost port 9000
Where can I get listmonk?
The source code and installation instructions are on GitHub: https://github.com/knadh/listmonk

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects