knadh

knadh/listmonk

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

View on GitHub Website / Demo Back to listing

24.3kstars 2.8kforks 100+contributors Go

README.md

[![listmonk-logo](https://user-images.githubusercontent.com/547147/231084896-835dba66-2dfe-497c-ba0f-787564c0819e.png)](https://listmonk.app)

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](https://github.com/user-attachments/assets/689b5fbb-dd25-4956-a36f-e3226a65f9c4)](https://listmonk.app)

Visit [listmonk.app](https://listmonk.app) for more info. Check out the [**live demo**](https://demo.listmonk.app).

## Installation

### Docker

The latest image is available on DockerHub at [`listmonk/listmonk:latest`](https://hub.docker.com/r/listmonk/listmonk/tags?page=1&ordering=last_updated&name=latest).
Download and use the sample [docker-compose.yml](https://github.com/knadh/listmonk/blob/master/docker-compose.yml).

```shell
# 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](https://listmonk.app/docs/installation)

__________________

### Binary
- Download the [latest release](https://github.com/knadh/listmonk/releases) 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](https://listmonk.app/docs/installation)
__________________

## Developers
listmonk is free and open source software licensed under AGPLv3. If you are interested in contributing, refer to the [developer setup](https://listmonk.app/docs/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.

Repository info

Default branch: master
Latest version: v7.0.0-beta.2
Created: 26/06/2019
Last activity: 12/11/2026
License: AGPL-3.0
Open issues: 63
Watchers: 141

Topics

campaign campaign-management email-marketing email-subscription listmonk mailing-list newsletter newsletter-management newsletter-software self-hosted sms-gateway smtp transactional-emails

Contributors

knadh

1.7k contributions

dependabot[bot]

114 contributions

mr-karan

32 contributions

MaximilianKohler

24 contributions

vividvilla

15 contributions