listmonk

listmonk is a self-hosted, high-performance mailing list and newsletter manager. It comes as a standalone binary and the only dependency is a Postgres database.

While you can setup listmonk on docker container and the official documents contains detailed information, today our focus is to install it using binary on Ubuntu 22.04. we need to setup ubuntu machine and ssh into it

Let starts:

ssh into your ubuntu machine and run the update

sudo apt update

Install and setup Postgre SQL

sudo apt install postgresql postgresql-contrib

After installation, create a user and database for listmonk and provide privileges to a user on the newly created database

sudo -u postgres psql

create database listmonk;

create user listmonk with encrypted password 'listmonk0101';

grant all privileges on database listmonk to listmonk;

\q

Let's move to the next step to get the listmonk binary from github repository

wget https://github.com/knadh/listmonk/releases/download/v2.4.0/listmonk_2.4.0_linux_amd64.tar.gz

At the time of writing the blog, the latest release is 2.4.0, you can get the latest release from listmonk github repository

Extract the downloaded listmonk binary file and configure it:

tar -zxvf listmonk_2.4.0_linux_amd64.tar.gz

Generate the config file:

./listmonk --new-config

Edit config file and add our database details which we created in first step:

sudo nano config.toml

Do the following changes:

Since I am installing it locally behind the firewall, I will change the address to 0.0.0.0:9000, you can change it to your domain

Set the admin username and password

Update the db details to our database

Press Ctril + X then Y and Enter to save

Install the listmonk and run it

./listmonk --install

./listmonk

At this stage, you should be able to browse to listmonk admin panel using your machine ip with port 9000

your-ip-address:9000

Let's create the service to keep it alive even we close the terminal window:

For creating the service first, we need to move the listmonk files to directories

Move the config file to /etc/listmonk

sudo mkdir /etc/listmonk/

sudo mv config.toml /etc/listmonk/

Move the listmonk to /usr/bin

sudo mv listmonk /usr/bin/

Create the service file and paste the configuration from the link in listmonk github repository: Link

sudo nano /etc/systemd/system/listmonk.service

Do the following config changes:

ConditionPathExists=/etc/listmonk/config.toml

ExecStartPre=/usr/bin/listmonk --config /etc/listmonk/config.toml --upgrade --yes

ExecStart=/usr/bin/listmonk --config /etc/listmonk/config.toml $SYSTEMD_LISTMONK_ARGS

Comment out the below lines for systemcall or it will give dump error

#SystemCallFilter=@system-service

#SystemCallFilter=~@privileged @resources

Press Ctril + X and then y and Enter to save it

Enable and start the service

sudo systemctl daemon-reload

sudo systemctl enable listmonk.service

sudo systemctl start listmonk.service

Check the status of the service, it should be active and you should be able to connect to admin panel of listmonk:

Next: Install nginx and configure SSL