Search

Search IconIcon to open search

Listmonk

Last updated Apr 15, 2025

Self-hosted newsletter and mailing list manager. Performance and features packed into a single binary. Free and open source.

My new Newsletter is published with Listmonk on list.ssp.sh. So far I used Mailchimp. I also liked Buttondown, unfortunately, it costs 9$ for above 100 subscribers.

By using open source Listmonk, I have the sending emails and collecting and unsubscribing from a newsletter, which I needed. But I had to deploy it myself. I used Railway.app.

# Settings

# Automatic Confirm Subscription Email by Clicking in Email

Default behaviour, if you click on the confirm button in your email:

It wil infact not confirm yet, you need another click once again confirm on the linked page. I believe this is why many have not confirmed my email subscribtion, tough many are subcribing itself.

There is a workaround for this by pasting the following piece of JavaScript in Settings -> Appearance -> Public -> Custom Javascript:

1
document.querySelector(".optin-form").submit();

After that, the above confirm will open a browser window and automatically click/submit the button after opening the browser. I think this should be default as it won’t work if JavaScript it blocked in your browser.

# Automation

# Sending Emails of Newsletter with Amazon SES

Sending it with Amazon SES.

Make sure you set up and verify the domain, and set some other settings like SPF, DKIM, and DMARC records. Check Bulk or mass email service for Newsletter and Email Automation.

I think I used these checklists:

# RSS

Based on RSS new email - Provide an RSS integration for listmonk, a self-hosted newsletter and mailing list manager. GitHub - listmonk-rss: by Stephan Heuel.

I just enabled automatic email send when I create a new article based on my RSS-Feed. I used Above repo by Stephan and forked it. Locally I can run make dry_run or live:

1
2
cd ~/Documents/git/sspaeti.com/listmonk-rss
make create_campaign

It works like a charm. This will schedule a campaign with the latest articles since LAST_UPDATE with a delay of 180 minutes.

# This is how it looks

Make command:

New created campain on Listmonk:

And updated LAST_UPDATE on GitHub:

And the Email:

Wdyt? :)

# Welcome Emails

Listmonk does not support automatically sending welcome emails or other messages. It is better to use Email Automation, something like Mautic, as mentioned in the GitHub issue.

A hacky solution with Listmonk on Auto reply on subscription (Issue #206).

The alternative I use for now is PayHip, see on My Services.

# Tech Setup and Maintenance

# Upgrade Listmonk on Railapp

Railway Redeploy option
see more on Upgrade - listmonk / Documentation

# Backup Postgres DB

Check Automated PostgreSQL Backups.

Restoring data from the backup

Our data should is now being automatically backed up to our S3 bucket. If we ever want to restore this data to a database, we can do so very easily using pg_restore.

First, unzip the backup which is stored as a tar.gz file and then run:

1
pg_restore -d 'DATABASE_URL' BACKUP_FOLDER

In the above snippet, replace the DATABASE_URL with the connection URL of the database you’d like to restore the data to and the BACKUP_FOLDER with the name of the folder to which you extracted your backup zip file and voila, your backup has been restored!


Origin: Newsletter
References: listmonk - Free and open source self-hosted newsletter, mailing list manager, and transactional mails, Send Checklist for Reaching Audience
Created 2023-04-09