---
title: "Deploy Listmonk on StackBlaze"
description: "Deploy Listmonk, the open source newsletter and mailing list manager, with managed Postgres, a volume for uploaded media and a public HTTPS URL. The Super Admin is created for you at deploy, so the setup page is never open to visitors. You connect the SMTP provider your campaigns go out through."
category: "email, marketing, communication"
url: https://www.stackblaze.com/templates/listmonk
---

# Deploy Listmonk

Deploy Listmonk, the open source newsletter and mailing list manager, with managed Postgres, a volume for uploaded media and a public HTTPS URL. The Super Admin is created for you at deploy, so the setup page is never open to visitors. You connect the SMTP provider your campaigns go out through.

**[Deploy Listmonk on StackBlaze](https://dashboard.stackblaze.com/new/template/listmonk)**

## This stack

- **Listmonk**: Web service
- **PostgreSQL**: managed database · TCP:5432

## What you get

- **Subscribers and lists**: Keep subscribers with custom attributes, sort them into public or private lists with single or double opt in, and import them from CSV.
- **Campaign editor**: Write campaigns in rich text, HTML, Markdown or the visual builder, personalise them with template tags and preview before you send.
- **Test sends**: Send a test message to any subscriber address from the campaign page before you start the real send.
- **Views and clicks**: Each campaign counts views and link clicks, and the dashboard charts them over time. Unsubscribe links and the List-Unsubscribe header are added for you.
- **API and transactional mail**: Manage subscribers and campaigns over the REST API and send one off messages with transactional templates through the same SMTP servers.
- **Admin set at deploy**: Listmonk creates its first user on whoever visits first. The template creates the Super Admin during install with a generated password instead.

## After you deploy

1. **Sign in at /admin**: Copy LISTMONK_ADMIN_PASSWORD from the app’s Variables in the dashboard and sign in as admin. The first start installs the database in under a minute.
2. **Add your SMTP server**: Open Settings, SMTP and enter the server of a provider that allows newsletters from your own domain. Use Test connection, then set the default From address in Settings, General.
3. **Import subscribers and send a test**: Create a list, import your subscribers from CSV, write a campaign and send yourself a test message before you start it.

## How it is wired

- **Postgres holds everything**: Subscribers, lists, campaigns, templates, analytics and settings live in the attached database. Restart or redeploy the app and they are still there.
- **Media on a volume**: Images you upload to the media library live on a 5 GB volume mounted at /listmonk/uploads and are served from your public URL.
- **Root URL set for you**: Unsubscribe, tracking and media links in every email use the Root URL. The template sets it to the app URL on first start. Change it in Settings, General when you add a custom domain.
- **One replica**: Campaigns are queued and sent by the app process itself, so the template runs a single replica. Raise CPU and memory or the send rate in Settings, Performance as your lists grow.

## Common questions

### How do I sign in after deploy?

Open /admin on your public URL and sign in as admin. The password is generated at deploy and shown as LISTMONK_ADMIN_PASSWORD in the app’s Variables in the dashboard. Change it under Users once you are in.

### Can someone else claim my new instance?

No. Listmonk asks the first visitor to create the admin user when none exists. The template creates the Super Admin during the first install, and checks for that page on every start, so it is never shown.

### Which email service sends my campaigns?

The SMTP server you add in Settings, SMTP. Use a provider that allows bulk or marketing mail from your own domain, and set up its SPF and DKIM records. The StackBlaze Email add-on is for transactional mail such as password resets, so it is not connected to this template.

### Does it handle unsubscribes?

Yes. Every campaign email carries an unsubscribe link and a List-Unsubscribe header pointing at your instance, and subscribers can manage their lists on the preferences page.

### Can I protect the public subscription form?

Yes. Listmonk has a built in proof of work CAPTCHA (ALTCHA) you can turn on in Settings, Security, so bots cannot sign up addresses in bulk.

### Can I use my own domain?

Yes. Attach a custom domain from the dashboard, then set the Root URL in Settings, General to it so links in new emails use your domain.

### What does it cost?

You pay for the compute, storage and bandwidth Listmonk and Postgres use, not per subscriber or per email. Your SMTP provider bills sending separately.


Source: https://github.com/knadh/listmonk