Skip to main content

Self-Hosted Newsletter Platform

Build and manage mailing lists, send campaigns, and track engagement with a powerful, privacy-focused platform that you control.

Quick Start

Get listmonk running in minutes

1

Download and Run

Deploy listmonk with Docker or download the binary for your platform.
Docker
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml
docker compose up -d
Visit http://localhost:9000 to access the dashboard.
2

Create Your First List

Navigate to Lists in the dashboard and create a new mailing list. Choose between public (open subscription), private (invitation only), or temporary lists.
Public lists can have opt-in pages that subscribers can use to sign up directly.
3

Add Subscribers

Import subscribers via CSV upload, use the API, or add them manually through the dashboard. Subscribers can belong to multiple lists and have custom attributes stored as JSON.
Use the /api/subscribers endpoint to programmatically manage your subscriber base.
4

Create and Send a Campaign

Design your email using the visual editor or write HTML directly. Choose your target lists, schedule or send immediately, and track opens, clicks, and bounces in real-time.

Core Features

Everything you need for email marketing and newsletters

Subscriber Management

Organize subscribers with custom attributes, segmentation, and list management

Campaign Builder

Create beautiful emails with templates, scheduling, and A/B testing

Template Designer

Visual email editor with drag-and-drop components and HTML support

Bounce Handling

Automatic bounce processing with SES, Sendgrid, and Postmark webhooks

Analytics

Track opens, clicks, bounces, and unsubscribes with detailed reporting

Transactional API

Send one-off emails via REST API for notifications and alerts

Explore by Topic

Deep dive into specific areas

Installation

Docker, binary, and production deployment guides

Configuration

SMTP setup, authentication, and privacy settings

API Reference

Complete REST API documentation with examples

Lists & Subscribers

Managing mailing lists and subscriber data

Email Providers

Configure SMTP, SES, Sendgrid, and more

Integrations

Connect with external services and webhooks

Ready to get started?

Deploy listmonk in minutes and take control of your email campaigns. Open source, self-hosted, and privacy-focused.

Build docs developers (and LLMs) love