katheryn-website/backlog/tasks/task-9 - Set-up-Listmonk-ne...

1.7 KiB

id title status assignee created_date labels dependencies priority
task-9 Set up Listmonk newsletter with Mailcow SMTP In Progress
2026-02-03 08:16
infrastructure
newsletter
katheryn-website
medium

Description

Deploy Listmonk self-hosted newsletter manager on Netcup RS 8000 and configure Mailcow as the SMTP relay for sending.

Requirements:

  • Deploy Listmonk via Docker with Traefik labels (newsletter.jeffemmett.com)
  • Configure Mailcow SMTP (orders@katheryntrenshaw.com via mail.rmail.online)
  • Set up subscriber list for Katheryn Trenshaw updates
  • Connect subscribe forms on katheryn-staging site to Listmonk API
  • Test end-to-end: subscribe → receive confirmation → receive newsletter

Acceptance Criteria

  • #1 Listmonk deployed and accessible via web UI
  • #2 Mailcow SMTP configured and sending test emails
  • #3 Subscribe form on katheryn site connected to Listmonk
  • #4 End-to-end test: subscribe and receive newsletter

Notes

2026-04-03 — Deployed

  • Listmonk v5.1.0 deployed at https://newsletter.jeffemmett.com
  • Postgres 16-alpine DB, Traefik routing, Cloudflare tunnel + DNS
  • Cloudflare Access protects admin UI; bypass for /api/subscribers and /api/public
  • SMTP: orders@katheryntrenshaw.com via mail.rmail.online:587 STARTTLS
  • "Katheryn Trenshaw Newsletter" list created (ID 3, public, double opt-in)
  • API user api-frontend with token auth for frontend integration
  • Frontend subscribe route updated to call Listmonk API (token auth)
  • Fallback to email notifications when Listmonk env vars not set (local dev)
  • AC #4 pending: needs frontend rebuild+deploy, then real email test