mirror of
https://github.com/knadh/listmonk.git
synced 2024-12-27 01:14:31 +08:00
7fcc6f71e2
- Remove "demo", "production" containers and have just one. - Remove dependency on config.toml and inline config to env vars. - Have a single idempotent instal+upgrade+run command that eliminates the need for manual upgrade steps. - Remove `.sh` install scripts. - Simplify and clean up install and update docs.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
<a href="https://zerodha.tech"><img src="https://zerodha.tech/static/images/github-badge.svg" align="right" /></a>
|
|
|
|
[](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 (⩾ 12) database as its data store.
|
|
|
|
[](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 -O https://github.com/knadh/listmonk/blob/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.
|