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_USERenvironment variable - Admin Password: Set via
LISTMONK_ADMIN_PASSWORDenvironment 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