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
Leave a Reply
You must be logged in to post a comment.