Deploy Listmonk
Run your newsletter and mailing lists on your own 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.
What you get with Listmonk
- Subscribers and listsKeep subscribers with custom attributes, sort them into public or private lists with single or double opt in, and import them from CSV.
- Campaign editorWrite campaigns in rich text, HTML, Markdown or the visual builder, personalise them with template tags and preview before you send.
- Test sendsSend a test message to any subscriber address from the campaign page before you start the real send.
- Views and clicksEach 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 mailManage subscribers and campaigns over the REST API and send one off messages with transactional templates through the same SMTP servers.
- Admin set at deployListmonk creates its first user on whoever visits first. The template creates the Super Admin during install with a generated password instead.
After you deploy Listmonk
- 1Sign in at /adminCopy 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.
- 2Add your SMTP serverOpen 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.
- 3Import subscribers and send a testCreate a list, import your subscribers from CSV, write a campaign and send yourself a test message before you start it.
How Listmonk is wired
Listmonk and Postgres ship together. The public hostname serves the admin under /admin and the subscriber pages (subscription form, preferences, archive) on the same host. Uploaded media sits on a volume.
- 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.
Why run Listmonk on StackBlaze
- Scale your appChange CPU, RAM, and replicas without a rebuild, or let autoscaling add replicas when CPU climbs.
- Git-based CI/CDPush to GitHub and it builds and ships. Pull requests get their own preview URL on Pro and Business.
- One-click rollbackA deploy went wrong? Go back to any previous successful deploy.
- Environments built inProduction, staging, and dev as separate environments in one project, each with its own URL.
- Built-in observabilityCPU, memory, and response time per app, live logs with search, and alerts to Slack, Discord, or a webhook.
- Developer-first toolsA CLI and Stack MCP: deploy, read logs, and wire services from your terminal or your AI assistant.
- Built for teamsInvite teammates with roles. An audit log records who changed what.
- Managed Postgres with HAPostgres is run for you. Turn on high availability for a three-node cluster when the app needs it.
Common questions about Listmonk
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. Custom domains
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. Pricing