How do I self-host Listmonk?

Listmonk can be deployed using Docker Compose. The AltStack provides a production-ready configuration that you can deploy on your own server. Simply copy the configuration and run it on any machine with Docker installed.

Is Listmonk free to self-host?

Yes, Listmonk is open source under the AGPL-3.0 and free to self-host. Your only costs are the server infrastructure. A basic cloud VPS starts at around $5-10/month.

What programming language is Listmonk built with?

Listmonk is built with Go. It has 23,776 stars on GitHub, indicating strong community adoption and support.

Back to Self-Hosted Stacks

Deploy Listmonk

High performance, self-hosted newsletter and mailing list manager with a modern dashboard.

Quick Start

Create a directory

mkdir listmonk-self-hosted && cd listmonk-self-hosted

Create config file

Copy the content from the Config tab below into a file named docker-compose.yml

Deploy

docker compose up -d

Fast Track

Deploy Listmonk in Minutes

Use our optimized Docker templates to deploy Listmonk on any cloud provider. Get $200 in free credit to start on DigitalOcean.

Start with free creditDeploy on DigitalOcean

$200

Metadata

License

AGPL-3.0

Language

Last Updated

10/14/2026

Configuration

yaml

services:
  listmonk:
    image: listmonk/listmonk:latest
    container_name: listmonk
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "9000:9000"
    environment:
      - LISTMONK_app__address=0.0.0.0:9000
      - LISTMONK_db__host=db
      - LISTMONK_db__port=5432
      - LISTMONK_db__user=listmonk
      - LISTMONK_db__password=listmonk
      - LISTMONK_db__database=listmonk
    command: ["sh", "-c", "yes | ./listmonk --install && ./listmonk"]

  db:
    image: postgres:14-alpine
    container_name: listmonk-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=listmonk
      - POSTGRES_PASSWORD=listmonk
      - POSTGRES_DB=listmonk
    volumes:
      - listmonk_db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U listmonk"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  listmonk_db_data:

Community Notes

Help others by adding context, corrections, or warnings about this tool. Sign in to contribute.

No community notes yet. Be the first to add context.