Listmonk is an email marketing and newsletter application that is open source and self-hosted. In this tutorial, we will show you how to install Listmonk on the latest version of Elementary OS.
Before we begin, ensure that you have the following:
Listmonk requires some packages to be installed on your server for it to work correctly. First, open the terminal and run the following command to update the package lists:
sudo apt update
After that, install the required packages for Listmonk using the following command:
sudo apt install -y git curl unzip nginx php7.4-fpm php7.4-mysql php7.4-xml php7.4-mbstring php7.4-zip
This command installs some essential packages like webserver (NGINX), Git, CURL, and PHP's necessary packages to run Listmonk without any issues.
In this step, we will download and install Listmonk. Follow the commands below to get it done:
cd /var/www/html
sudo git clone https://github.com/knadh/listmonk.git
cd listmonk
sudo curl -s https://getcomposer.org/installer | php
sudo php composer.phar install --no-dev
The next step is to configure NGINX to serve Listmonk. Create the configuration file using the following command:
sudo nano /etc/nginx/sites-available/listmonk.conf
And add the following content to the file:
server {
listen 80;
listen [::]:80;
root /var/www/html/listmonk/public;
index index.html index.htm index.php;
server_name yourdomain.com;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~* \.(jpg|jpeg|png|gif|css|js|ico|webp|woff2|woff|eot|ttf)$ {
expires 1d;
access_log off;
add_header Cache-Control "public, no-transform";
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_read_timeout 300;
}
}
Change the "yourdomain.com" text to your domain name or IP address. Also, the configuration file assumes that you downloaded Listmonk in the "/var/www/html" directory. If you installed it somewhere else, adjust the configuration file accordingly.
After editing the configuration file, save and close it.
Next, create a symbolic link to enable the site configuration using the following command:
sudo ln -s /etc/nginx/sites-available/listmonk.conf /etc/nginx/sites-enabled/
Then restart Nginx service with:
sudo systemctl restart nginx
Next, create a database for Listmonk, and grant necessary privileges to the database user.
First, log in to MySQL:
sudo mysql -u root -p
And create a database, a user, and grant the necessary privileges using the commands below:
CREATE DATABASE listmonk_db;
CREATE USER 'listmonk_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON listmonk_db.* TO 'listmonk_user'@'localhost';
Exit from the MySQL shell:
exit
Install the Listmonk application using the following command:
sudo ./bin/listmonk install
And edit the file ".env" to modify the default settings:
sudo nano .env
Find and update the following parameters with your system's values:
APP_ENV=production
APP_DEBUG=false
APP_URL=http://your_ip_or_domain
APP_NAME="Listmonk Newsletter"
BACKEND_DOMAIN="mail.example.com"
DB_HOST=localhost
DB_DATABASE=listmonk_db
DB_USERNAME=listmonk_user
DB_PASSWORD=password
ENFORCE_HTTPS=false
MAIL_FROM_ADDRESS=info@example.com
After making the changes, save and close the file.
Listmonk is installed and configured on your system, and you can log in by visiting your server's IP address or domain name. From there, you can start creating newsletters and managing your email campaigns.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!
