From b58769ef62d6e987d89ff3a2aada79c4b8ed5fd8 Mon Sep 17 00:00:00 2001
From: Jorge - vitrubio <jorge@vitrubio.net>
Date: Wed, 19 May 2021 13:53:15 +0200
Subject: [PATCH] added Debian installation explanation in README

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/README.md b/README.md
index 32943c1..4aeab5f 100644
--- a/README.md
+++ b/README.md
@@ -32,11 +32,51 @@ More information on [docs](https://listmonk.app/docs).
 __________________
 
 ### Binary
+#### download an prepare config file
+
 - 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.
+
+#### prerequisites Debian: system user and PostgreSQL
+- install PostgreSQL `apt install postgresql`
+- create system user with config.toml data for the database: 
+     `adduser listmonk`
+- create the postgreSQL database, the user and grant permissions:
+     `su - postgres` and then acces de PostgreSQL console `psql`
+     ```
+     postgres=# CREATE DATABASE listmonk;
+     postgres=# CREATE USER listmonk WITH PASSWORD 'listmonk';
+     postgres=# GRANT ALL PRIVILEGES ON DATABASE listmonk TO listmonk;
+     ```
+#### proceed to install
 - `./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`.
 
+#### after install, fine tunning
+oncen checked it works, stop the process.
+- move the files to where you like most, usually `/opt/listmonk/` or inside `/var/www/html/`
+- change ownership of the files to `www-data` or whatever user you have assigned the webserver `chown -R www-data:www-data listmonk`
+- run listmonk as a service, create `/etc/systemd/system/listmonk.service` with:
+   ```
+   [Unit]
+   Description=Listmonk server
+   After=syslog.target network.target postgressql.target
+   
+   [Service]
+   Type=simple
+   # the user and group executing the service
+   User=www-data
+   Group=www-data
+   # the directory where you have listmonk
+   WorkingDirectory=/var/www/html/listmonk
+   # the file to execute
+   ExecStart=/var/www/html/listmonk/listmonk
+   Restart=always
+   RestartSec=10
+
+   [Install]
+   WantedBy=multi-user.target
+```
 __________________
 
 ### Heroku