{
  "manifest_version": "1",
  "slug": "listmonk",
  "title": "listmonk",
  "headline": "Self-host listmonk",
  "description": "Run listmonk on an exe.dev VM with Docker and PostgreSQL: a private admin, public unsubscribe and signup pages, sending via SES, Postmark or Resend.",
  "category": "productivity",
  "tags": [
    "newsletter",
    "mailing list",
    "email marketing",
    "mailchimp alternative",
    "listmonk docker",
    "smtp",
    "amazon ses",
    "postmark",
    "resend",
    "postgresql",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/listmonk",
  "markdown_url": "https://exe.dev/deploy/listmonk.md",
  "upstream": {
    "website": "https://listmonk.app",
    "source": "https://github.com/knadh/listmonk",
    "docs": "https://listmonk.app/docs/",
    "license": "AGPL-3.0"
  },
  "example_vm_name": "my-listmonk",
  "time": "15 minutes",
  "stack": [
    {
      "name": "listmonk 6.2",
      "detail": "listmonk/listmonk:v6.2.0, admin, API and subscriber pages",
      "port": 9000,
      "data": "~/listmonk/uploads"
    },
    {
      "name": "PostgreSQL 17",
      "detail": "postgres:17-alpine; subscribers, lists, campaigns, settings",
      "data": "~/listmonk/postgres"
    },
    {
      "name": "Public proxy",
      "detail": "nginx; subscriber pages, tracking, media and bounce webhooks, nothing else",
      "port": 8000
    },
    {
      "name": "Test inbox",
      "detail": "Mailpit; catches every email until you connect a provider",
      "port": 8025
    },
    {
      "name": "Nightly backup",
      "detail": "pg_dump and uploads from a systemd timer; keeps two weeks",
      "data": "~/listmonk/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-listmonk.exe.xyz:9000/admin/",
      "who": "private",
      "what": "The listmonk admin and API, behind exe.dev login and listmonk's own"
    },
    {
      "url": "https://my-listmonk.exe.xyz:8025/",
      "who": "private",
      "what": "The Mailpit test inbox"
    },
    {
      "url": "https://my-listmonk.exe.xyz/subscription/form",
      "who": "public",
      "what": "Signup, opt-in, unsubscribe, archive, tracking and bounce webhooks, once you make the VM public"
    }
  ],
  "delivers": [
    "listmonk 6.2 on PostgreSQL 17, restarted after a reboot.",
    "A private admin on port 9000 and a public port that answers only subscriber-facing paths.",
    "Links in emails that point at https://\u003cvm\u003e.exe.xyz, not localhost.",
    "A test inbox that catches all mail until the owner connects SES, Postmark or Resend.",
    "Nightly backups of the database, uploads and secrets."
  ],
  "owner_runs_after": [
    "ssh exe.dev share set-public my-listmonk   # subscribers' unsubscribe and opt-in links need this"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20listmonk%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Flistmonk.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-listmonk.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-listmonk.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20listmonk%206.2%20on%20PostgreSQL%2017%2C%20restarted%20after%20a%20reboot.%0A-%20A%20private%20admin%20on%20port%209000%20and%20a%20public%20port%20that%20answers%20only%20subscriber-facing%20paths.%0A-%20Links%20in%20emails%20that%20point%20at%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2C%20not%20localhost.%0A-%20A%20test%20inbox%20that%20catches%20all%20mail%20until%20the%20owner%20connects%20SES%2C%20Postmark%20or%20Resend.%0A-%20Nightly%20backups%20of%20the%20database%2C%20uploads%20and%20secrets.%0A%0ARead%20the%20whole%20recipe%2C%20including%20closed%20details%2C%20and%20follow%20%22Install%20by%0Ahand%22%20first.%20The%20walkthrough%20before%20it%20is%20for%20the%20owner%20afterwards.%20Do%0Anot%20run%20the%20Restore%20or%20Update%20instructions.%0AWork%20as%20exedev%20in%20~%2Flistmonk.%20Never%20overwrite%20an%20existing%20~%2Flistmonk%2F.env.%0ADo%20not%20connect%20an%20email%20provider%2C%20import%20subscribers%20or%20send%20campaigns%3A%0Athe%20owner%20does%20that.%20Leave%20public%20sharing%20off%3B%20only%20the%20owner%20can%20turn%20it%0Aon.%20Verify%20docker.service%20is%20enabled%2C%20the%20four%20containers%20are%20restart%0Aunless-stopped%20and%20up%20%28db%20and%20app%20healthy%29%2C%20localhost%3A9000%2Fhealth%0Aanswers%20%7B%22data%22%3Atrue%7D%2C%20localhost%3A8000%2Fsubscription%2Fform%20returns%20200%2C%20and%0Alocalhost%3A8000%2Fadmin%2F%20and%20localhost%3A8000%2Fapi%2Flists%20return%20404.%20Check%20the%0Abackup%20timer%20is%20enabled%20and%20the%20first%20dump%20exists%20in%20~%2Flistmonk%2Fbackups.%0AFinish%20with%20the%20admin%20URL%20on%20port%209000%2C%20the%20user%20name%20admin%20and%20the%0Apassword%20from%20LISTMONK_ADMIN_PASSWORD%20in%20~%2Flistmonk%2F.env%2C%20the%20test%20inbox%0AURL%20on%20port%208025%2C%20and%20the%20command%20the%20owner%20runs%20on%20their%20own%20computer%20to%0Amake%20subscriber%20pages%20public%3A%20ssh%20exe.dev%20share%20set-public%20my-listmonk%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20ssh%20exe.dev%20share%20set-public%20my-listmonk%20%20%20%23%20subscribers%27%20unsubscribe%20and%20opt-in%20links%20need%20this%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/listmonk/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up listmonk on this VM by following the exe.dev recipe at https://exe.dev/deploy/listmonk.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-listmonk. This VM's name is the output of `hostname`: use it wherever the recipe writes my-listmonk. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- listmonk 6.2 on PostgreSQL 17, restarted after a reboot.\n- A private admin on port 9000 and a public port that answers only subscriber-facing paths.\n- Links in emails that point at https://\u003cvm\u003e.exe.xyz, not localhost.\n- A test inbox that catches all mail until the owner connects SES, Postmark or Resend.\n- Nightly backups of the database, uploads and secrets.\n\nRead the whole recipe, including closed details, and follow \"Install by\nhand\" first. The walkthrough before it is for the owner afterwards. Do\nnot run the Restore or Update instructions.\nWork as exedev in ~/listmonk. Never overwrite an existing ~/listmonk/.env.\nDo not connect an email provider, import subscribers or send campaigns:\nthe owner does that. Leave public sharing off; only the owner can turn it\non. Verify docker.service is enabled, the four containers are restart\nunless-stopped and up (db and app healthy), localhost:9000/health\nanswers {\"data\":true}, localhost:8000/subscription/form returns 200, and\nlocalhost:8000/admin/ and localhost:8000/api/lists return 404. Check the\nbackup timer is enabled and the first dump exists in ~/listmonk/backups.\nFinish with the admin URL on port 9000, the user name admin and the\npassword from LISTMONK_ADMIN_PASSWORD in ~/listmonk/.env, the test inbox\nURL on port 8025, and the command the owner runs on their own computer to\nmake subscriber pages public: ssh exe.dev share set-public my-listmonk\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  ssh exe.dev share set-public my-listmonk   # subscribers' unsubscribe and opt-in links need this\n",
    "prompt_url": "https://exe.dev/deploy/listmonk/prompt.txt"
  },
  "published": "2026-11-21",
  "updated": "2026-11-21",
  "verified": "2026-11-21",
  "related": [
    "postgres",
    "umami",
    "chatwoot",
    "docker-compose",
    "cal-diy",
    "excalidraw"
  ],
  "alternatives": [
    "Mailchimp",
    "Substack",
    "ConvertKit"
  ],
  "files": [
    "https://exe.dev/deploy/listmonk/mailchimp-to-listmonk.py"
  ]
}
