Listmonk¶
Self-hosted newsletter and mailing list manager.
Overview¶
Listmonk is a modern, feature-rich newsletter and mailing list manager designed for high performance and easy management. It provides a complete solution for email campaigns, subscriber management, and analytics.
Features¶
- Newsletter and email campaign management
- Subscriber list management
- Template system with HTML/markdown support
- Campaign analytics and tracking
- API for integration
- Multi-list support
- Bounce handling
- Privacy-focused design
Access¶
- Default Port: 9000
- URL:
http://localhost:9000
- Admin User: Set via
LISTMONK_ADMIN_USER
environment variable - Admin Password: Set via
LISTMONK_ADMIN_PASSWORD
environment variable
Configuration¶
Environment Variables¶
LISTMONK_ADMIN_USER
: Admin usernameLISTMONK_ADMIN_PASSWORD
: Admin passwordPOSTGRES_USER
: Database usernamePOSTGRES_PASSWORD
: Database passwordPOSTGRES_DB
: Database name
Database¶
Listmonk uses PostgreSQL as its backend database. The database is automatically configured through the docker-compose setup.
Uploads¶
- Upload directory:
./assets/uploads
- Used for media files, templates, and attachments
Getting Started¶
- Access Listmonk at
http://localhost:9000
- Log in with your admin credentials
- Set up your first mailing list
- Configure SMTP settings for sending emails
- Import subscribers or create subscription forms
- Create your first campaign
Important Notes¶
- Configure SMTP settings before sending emails
- Set up proper domain authentication (SPF, DKIM) for better deliverability
- Regularly backup your subscriber data and campaigns
- Monitor bounce rates and maintain list hygiene
Official Documentation¶
For comprehensive guides and API documentation, visit: - Listmonk Documentation - GitHub Repository