# listmonk

listmonk is an open-source newsletter and mailing list manager written in Go, packaged here so small businesses, creators and developers can run their own Mailchimp alternative on PostgreSQL in one click. It covers subscribers and lists with single or double opt-in, campaigns in rich text, HTML or Markdown sent through your own SMTP provider, and opens, clicks and bounces per campaign.

- Framework: Dockerfile (Docker)
- Category: Apps / Newsletters and links
- Creates: a server app and a PostgreSQL database on the Shared tier (1 GB)
- Plan: Lite or above
- Price: Free
- Author: Light Cloud
- Page: https://templates.light-cloud.com/apps/marketing/listmonk
- Updated: 2026-11-21

## Features

- The official listmonk 6.2.0 image, pinned to an exact release, with schema install and migrations run on every start
- Subscribers with custom JSON attributes, CSV import and export, blocklisting and segments written as SQL queries
- Public and private lists with single or double opt-in, a hosted subscription form and a preference page
- Campaigns in rich text, raw HTML, Markdown or plain text, with Go templates for personalisation, attachments and scheduling
- Opens, link clicks and bounces per campaign, with bounce processing from a mailbox or a provider webhook
- A transactional email API, several SMTP servers at once, and users with roles and per-list permissions
- The first super admin comes from generated environment variables, so nobody can claim an empty install

## What you need

- A paid plan: deploying creates a PostgreSQL database, which the Free plan does not include
- One always-on instance (minimum 1, maximum 1), billed for the whole month, so it is not a Free plan fit
- To run it locally: Docker, for the image and a PostgreSQL container
- Your own SMTP provider such as Amazon SES, Postmark or Brevo, set in the app; without it no email is sent
- S3-compatible storage for media uploads, set in the app; without it uploaded images are lost on restart

## About

This is upstream listmonk 6.2.0 by Kailash Nadh and contributors, under its own AGPL-3.0 licence and unchanged (the 7.0 line is still in beta): Light Cloud packages the official image for a one-click deploy, nothing more. lightcloud/start.sh rebuilds Light Cloud's DATABASE_URL into listmonk's LISTMONK_db__* settings, keeping only sslmode, then runs upstream's idempotent install and upgrade before the server; everything else, from the root URL to SMTP, media and bounces, is set in the app under Settings and stored in PostgreSQL. Email needs your own SMTP provider, because Light Cloud does not send email for apps, and media uploads need S3-compatible storage, because the container's disk does not survive restarts. It must run as exactly one always-on instance (minimum 1, maximum 1), billed all month: a sleeping instance stops sending campaigns and scheduled sends, and a second one would send every campaign twice. Set the root URL first, since the default http://localhost:9000 goes into every unsubscribe and tracking link, and delete the two sample subscribers, the two sample lists and the welcome campaign the installer adds.

## Variables

- `LISTMONK_ADMIN_USER`: filled in
- `LISTMONK_ADMIN_PASSWORD`: generated. Sign in as admin with this password.

## Questions

### Is listmonk a good free alternative to Mailchimp?

For sending newsletters to your own lists, yes: subscribers, opt-in lists, campaigns, templates and open and click statistics, with no per-subscriber pricing. You bring the email delivery (an SMTP provider such as Amazon SES), which is usually far cheaper than Mailchimp at volume.

### What SMTP provider should I use with listmonk?

Any provider that offers SMTP works: Amazon SES is the cheapest at volume, while Postmark, Mailgun, Brevo and Resend are simpler to set up. Add it under Settings, SMTP and use the provider's bounce webhook for bounce handling.

### How do I import subscribers into listmonk?

Under Subscribers, Import, upload a CSV with email and name columns (plus any attributes as JSON), choose the lists, and pick whether to subscribe them as confirmed or send an opt-in email.

### Why does listmonk need an always-on server?

Campaigns are sent by a background process inside listmonk, and scheduled campaigns start at their time without anyone opening the app. A container that scales to zero or sleeps between requests stops sending, so run one instance that is always on.

### What is the default listmonk admin password?

There is none: listmonk creates the first super admin from LISTMONK_ADMIN_USER and LISTMONK_ADMIN_PASSWORD when the database is set up. On Light Cloud the user is admin and the password is generated; it is in the app's environment variables.
