High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.
  • Go 41.3%
  • Vue 24.9%
  • JavaScript 19.7%
  • TypeScript 8.8%
  • HTML 1.8%
  • Other 3.4%
Find a file
2026-04-30 00:16:19 +05:30
.devcontainer Fix outdated docker local dev suite (#2200) 2024-12-10 23:05:12 +05:30
.github Bump Hodor to 0.3.4 (adds python3, shellcheck, file, diffstat) (#2943) 2026-03-07 09:18:43 +05:30
cmd Skip empty config fields in Postgres connect DSN. Closes #2275. 2026-04-30 00:01:47 +05:30
dev fix: Update dev Dockerfile to use Go 1.24.1 to match go.mod (#2879) 2026-01-29 17:26:29 +05:30
docs Add template expression support to campaign custom headers like subjects. 2026-04-28 17:39:13 +05:30
frontend Bump postcss from 8.4.49 to 8.5.12 in /frontend (#3020) 2026-04-28 16:31:39 +05:30
i18n Add template expression support to campaign custom headers like subjects. 2026-04-28 17:39:13 +05:30
internal Add template expression support to campaign custom headers like subjects. 2026-04-28 17:39:13 +05:30
models Add template expression support to campaign custom headers like subjects. 2026-04-28 17:39:13 +05:30
queries Prevent confirmed subscriber becoming unconfirmed when re-subscribing. Closes #2987 (#2996) 2026-04-30 00:16:19 +05:30
scripts Auto-translate new i18n language strings. 2025-09-09 22:35:48 +05:30
static Remove unpredictable/useless 'back' button from public forms. Closes #1834. 2026-03-29 16:28:17 +05:30
.dockerignore feat: Add blobstore package 2019-10-31 11:25:31 +05:30
.gitattributes Added end of line config for git 2022-01-26 09:50:06 +01:00
.gitignore Add docker-compose.override.yml to .gitignore (#2917) 2026-02-22 17:52:53 +05:30
.go-version build: bump Go version to 1.26.1 to fix stdlib CVEs (#2941) 2026-03-07 00:33:44 +05:30
.goreleaser-nightly.yml Skip windows/arm-32 bit builds in goreleaser (which was breaking) that was removed in go 1.26 2026-03-08 00:07:31 +05:30
.goreleaser.yml Skip windows/arm-32 bit builds in goreleaser (which was breaking) that was removed in go 1.26 2026-03-08 00:07:31 +05:30
config.toml.sample Remove admin user/password from sample config generation. 2024-10-13 16:59:52 +05:30
CONTRIBUTING.md Fix link to the docs repo. 2023-03-26 11:17:15 +05:30
docker-compose.yml Change LISTMONK_db__host from 'listmonk_db' to 'db' (#2787) 2025-11-28 13:30:01 +05:30
docker-entrypoint.sh Add support for loading secrets from *_FILE env vars in Docker environment. 2025-08-09 14:41:13 +05:30
Dockerfile #2114 - Fix issue of wrong platform used during docker build (#2123) 2024-10-30 10:13:00 +05:30
go.mod Remove accidentally (!) committed local lib path. Ughhhhh ;( 2026-04-28 16:31:21 +05:30
go.sum Remove accidentally (!) committed local lib path. Ughhhhh ;( 2026-04-28 16:31:21 +05:30
LICENSE Refactor and add new build routines 2019-07-09 15:57:04 +05:30
listmonk-simple.service Update listmonk-simple.service - add optional log file (#1640) 2024-01-09 23:41:14 +05:30
listmonk@.service Enable extra system calls in systemd service (#1309) 2023-07-12 19:42:54 +05:30
Makefile Incorporate SOURCE_DATE_EPOCH in build. Closes #2802. 2026-02-23 23:51:32 +05:30
permissions.json Add new campaigns:send permission and separate it from campaigns:manage. 2026-03-29 16:16:55 +05:30
project.inlang.json fix: update inlang settings (#1529) 2023-09-20 14:19:08 +05:30
README.md Update screenshot on README. 2025-04-29 00:08:33 +05:30
schema.sql Add ability to set a retry delay for failed SMTP pushes. Closes #2309. 2026-04-28 15:40:34 +05:30
SECURITY.md Add a link to security reporting docs to SECURITY.md 2026-02-23 12:28:32 +05:30
VERSION Add a VERSION file for git-archive export 2021-08-14 13:41:19 +05:30

listmonk-logo

listmonk is a standalone, self-hosted, newsletter and mailing list manager. It is fast, feature-rich, and packed into a single binary. It uses a PostgreSQL database as its data store.

listmonk-dashboard

Visit listmonk.app for more info. Check out the live demo.

Installation

Docker

The latest image is available on DockerHub at listmonk/listmonk:latest. Download and use the sample docker-compose.yml.

# 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

Visit http://localhost:9000

See installation docs


Binary

  • Download the latest release and extract the listmonk binary.
  • ./listmonk --new-config to generate config.toml. Edit it.
  • ./listmonk --install to setup the Postgres DB (or --upgrade to upgrade an existing DB. Upgrades are idempotent and running them multiple times have no side effects).
  • Run ./listmonk and visit http://localhost:9000

See installation docs


Developers

listmonk is free and open source software licensed under AGPLv3. If you are interested in contributing, refer to the developer setup. The backend is written in Go and the frontend is Vue with Buefy for UI.

License

listmonk is licensed under the AGPL v3 license.