beenull/listmonk
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
listmonk/README.md

56 lines
2.4 KiB
Markdown
Raw Normal View History

Add zerodha.tech badge
2020-09-21 18:16:57 +00:00
<a href="https://zerodha.tech"><img src="https://zerodha.tech/static/images/github-badge.svg" align="right" /></a>
Add white background to logo in README for dark mode. Closes #1268.
2023-04-11 07:21:24 +00:00
[![listmonk-logo](https://user-images.githubusercontent.com/547147/231084896-835dba66-2dfe-497c-ba0f-787564c0819e.png)](https://listmonk.app)
Refactor README for publishing
2019-06-26 10:35:50 +00:00
Add a note on Postgres min version.
2021-11-09 17:13:44 +00:00
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 (⩾ v9.4) database as its data store.
Update README with image and links
2019-07-09 11:36:23 +00:00
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
[![listmonk-dashboard](https://user-images.githubusercontent.com/547147/134939475-e0391111-f762-44cb-b056-6cb0857755e3.png)](https://listmonk.app)
Visit [listmonk.app](https://listmonk.app) for more info. Check out the [**live demo**](https://demo.listmonk.app).
Refactor README for publishing
2019-06-26 10:35:50 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
## Installation
Refactor README for publishing
2019-06-26 10:35:50 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
### Docker
Add support for loading custom static files with `--static-dir` - Removed duplicate copies of static files in `static/public/`
2020-03-14 15:37:14 +00:00
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
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). Use the sample [docker-compose.yml](https://github.com/knadh/listmonk/blob/master/docker-compose.yml) to run manually or use the helper script.
feat: Add docker instructions
2019-07-12 02:21:48 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
#### Demo
feat: Add shell script for demo setup
2021-01-21 16:06:32 +00:00
```bash
CD to directory before install script Change directory to newly created before running install script
2021-09-21 18:33:37 +00:00
mkdir listmonk-demo && cd listmonk-demo
feat: Add easy install script - Add a shell script to orchestrate a production setup with `docker-compose`. The script fetches config and `docker-compose.yml` from the `master` branch, generates a secure password, performs DB migrations and starts the container services. - Add a health check for Postgres container service in `docker-compose.yml`. - Add cusotm `container_name` for services inside `docker-compose`. This is helpful to check the status of containers in the install shell script.
2021-06-14 13:50:13 +00:00
sh -c "$(curl -fsSL https://raw.githubusercontent.com/knadh/listmonk/master/install-demo.sh)"
feat: Add shell script for demo setup
2021-01-21 16:06:32 +00:00
```
feat: Add docker image link to README
2019-07-12 12:27:32 +00:00
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
DO NOT use this demo setup in production.
feat: Add docker instructions
2019-07-12 02:21:48 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
#### Production
feat: Add easy install script - Add a shell script to orchestrate a production setup with `docker-compose`. The script fetches config and `docker-compose.yml` from the `master` branch, generates a secure password, performs DB migrations and starts the container services. - Add a health check for Postgres container service in `docker-compose.yml`. - Add cusotm `container_name` for services inside `docker-compose`. This is helpful to check the status of containers in the install shell script.
2021-06-14 13:50:13 +00:00
```bash
CD to directory before install script Change directory to newly created before running install script
2021-09-21 18:33:37 +00:00
mkdir listmonk && cd listmonk
feat: Add easy install script - Add a shell script to orchestrate a production setup with `docker-compose`. The script fetches config and `docker-compose.yml` from the `master` branch, generates a secure password, performs DB migrations and starts the container services. - Add a health check for Postgres container service in `docker-compose.yml`. - Add cusotm `container_name` for services inside `docker-compose`. This is helpful to check the status of containers in the install shell script.
2021-06-14 13:50:13 +00:00
sh -c "$(curl -fsSL https://raw.githubusercontent.com/knadh/listmonk/master/install-prod.sh)"
```
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
Visit `http://localhost:9000`.
feat: Add easy install script - Add a shell script to orchestrate a production setup with `docker-compose`. The script fetches config and `docker-compose.yml` from the `master` branch, generates a secure password, performs DB migrations and starts the container services. - Add a health check for Postgres container service in `docker-compose.yml`. - Add cusotm `container_name` for services inside `docker-compose`. This is helpful to check the status of containers in the install shell script.
2021-06-14 13:50:13 +00:00
Fix typo
2021-09-28 13:22:34 +00:00
**NOTE**: Always examine the contents of shell scripts before executing them.
feat: Add docker instructions
2019-07-12 02:21:48 +00:00
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
See [installation docs](https://listmonk.app/docs/installation).
feat: Add separate config for demo setup, tweak docs This PR adds `config-demo.toml` to `Dockerfile` which uses the db host `demo-db`. This is more suited for demo setups. For normal docker installations the db host is changed back to `db` which is a better sane default. Reworded `INSTALL.md` and `README.md` for more clarity on docker installation and configuration.
2020-07-08 17:08:31 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
__________________
feat: Add docker demo setup
2019-07-12 08:20:44 +00:00
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
### Binary
- Download the [latest release](https://github.com/knadh/listmonk/releases) and extract the listmonk binary.
- `./listmonk --new-config` to generate config.toml. Then, edit the file.
- `./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`.
Add note about Heroku deploy button The Heroku deploy button provides automated on-click deployments to Heroku.
2020-04-02 10:23:01 +00:00
Update README to reflect v2.0.0 changes.
2021-09-27 15:48:01 +00:00
See [installation docs](https://listmonk.app/docs/installation).
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
__________________
Refactor README for publishing
2019-06-26 10:35:50 +00:00
## Developers
Add rebranded design elements. - New logo and favicon and new splash image + intro text in the README.
2020-08-09 13:45:44 +00:00
listmonk is a 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.
Refactor README for publishing
2019-06-26 10:35:50 +00:00
Refactor and add new build routines - Fix version injection in build - Refactor Makefile - Add --new-config flag to generate sample config - Add license - Remove autogenerated frontend README - Refactor make dist to do end-to-end build - Refactor build and add goreleaser conf
2019-07-08 12:51:44 +00:00
## License
listmonk is licensed under the AGPL v3 license.
Reference in a new issue Copy permalink