How knadh/listmonk works
listmonk is a self-hosted newsletter and mailing-list manager. Administrators use the Vue application (and embedded email builder) to manage lists, subscribers, templates, media, and campaigns. Requests pass through authenticated HTTP handlers into domain services and PostgreSQL. The campaign manager batches eligible subscribers, renders messages, loads media, and sends through SMTP. Public forms collect subscriptions, while bounce integrations feed delivery events back into the system. Sampled code confirms startup, routing, authentication, campaign storage, delivery, and frontend API boundaries; some unsampled handler-to-domain calls are represented at subsystem level.
Main entry points: handlers.go HTTP Handlers · main.go Application Runtime · App.vue Admin UI · media.go Media Store
Components 26
Web Applications
- Admin UI
frontend/src/App.vue - Public Forms
frontend/src/views/Forms.vue - Email Builder
frontend/email-builder/src/main.tsx - API Client
frontend/src/api/index.js
HTTP and Auth
- HTTP Handlers
cmd/handlers.go - Authentication
internal/auth/auth.go - Application Runtime
cmd/main.go
Domain Services
- Core Services
internal/core/core.go - Lists and Audiences
internal/core/lists.go - Subscriber Management
internal/core/subscribers.go - Campaign Management
internal/core/campaigns.go - Template Management
internal/core/templates.go - Dashboard Analytics
internal/core/dashboard.go
Campaign Delivery
- Campaign Manager
internal/manager/manager.go - Email Messenger
internal/messenger/email/email.go - Bounce Processing
internal/bounce/bounce.go
Storage and Events
- Campaign Store
cmd/manager_store.go - Media Store
internal/media/media.go - Filesystem Media
internal/media/providers/filesystem/filesystem.go - S3 Media
internal/media/providers/s3/s3.go - PostgreSQL
- Event Stream
internal/events/events.go
Other components
- Administrator
- Subscriber
- SMTP Service
- Bounce Providers
Connections 27
- Administrator → Admin UI: uses
- Subscriber → Public Forms: submits forms
- Admin UI → API Client: issues requests
- Public Forms → API Client: submits data
- Admin UI → Email Builder: edits emails
- API Client → HTTP Handlers: calls API
- HTTP Handlers → Authentication: checks access
- HTTP Handlers → Core Services: dispatches requests
- HTTP Handlers → Lists and Audiences: manages lists
- HTTP Handlers → Subscriber Management: manages subscribers
- HTTP Handlers → Campaign Management: manages campaigns
- HTTP Handlers → Template Management: manages templates
- HTTP Handlers → Media Store: manages media
- HTTP Handlers → Dashboard Analytics: reads analytics
- Application Runtime → HTTP Handlers: starts server
- Application Runtime → Campaign Manager: starts workers
- Application Runtime → Bounce Processing: starts scanning
- Campaign Manager → Campaign Store: loads campaigns
- Campaign Store → PostgreSQL: queries data
- Campaign Store → Media Store: loads blobs
- Campaign Manager → Email Messenger: pushes messages
- Email Messenger → SMTP Service: sends mail
- Media Store → Filesystem Media: uses provider
- Media Store → S3 Media: uses provider
- Bounce Providers → Bounce Processing: posts bounces
- Application Runtime → Event Stream: publishes logs
- Event Stream → Admin UI: streams events