Skip to content
/ listmonk Public

High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.

License

Notifications You must be signed in to change notification settings

knadh/listmonk

Repository files navigation

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 (⩾ 12) database as its data store.

listmonk-dashboard

Visitlistmonk.appfor more info. Check out thelive demo.

Installation

Docker

The latest image is available on DockerHub atlistmonk/listmonk:latest. Download and use the sampledocker-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

Visithttp://localhost:9000

Seeinstallation docs


Binary

  • Download thelatest releaseand extract the listmonk binary.
  • ./listmonk --new-configto generate config.toml. Edit it.
  • ./listmonk --installto setup the Postgres DB (or--upgradeto upgrade an existing DB. Upgrades are idempotent and running them multiple times have no side effects).
  • Run./listmonkand visithttp://localhost:9000

Seeinstallation docs


Developers

listmonk is free and open source software licensed under AGPLv3. If you are interested in contributing, refer to thedeveloper 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.