72 lines
4.2 KiB
Markdown
72 lines
4.2 KiB
Markdown
# Listmonk: Self-Hosted Newsletter & Mailing List Manager
|
|
|
|
The following content is provided by a third-party. For BNKops setup-guide for Listmonk:
|
|
|
|
[Listmonk Guide](../guides/listmonk.md){ .md-button }
|
|
|
|
Listmonk is a powerful, self-hosted newsletter and mailing list manager. It gives you complete control over your email campaigns, subscriber data, and messaging without relying on third-party services that might have restrictive terms, high costs, or data privacy concerns. It's ideal for building and engaging with your community.
|
|
|
|
## Key Features
|
|
|
|
* **Subscriber Management**: Import, organize, and segment your subscriber lists.
|
|
* **Campaign Creation**: Design and send email campaigns using rich text or plain Markdown.
|
|
* **Templating**: Create reusable email templates for consistent branding.
|
|
* **Analytics**: Track campaign performance with metrics like open rates, click-through rates, etc.
|
|
* **Double Opt-In**: Ensure compliance and list quality with double opt-in mechanisms.
|
|
* **Self-Hosted**: Full ownership of your data and infrastructure.
|
|
* **API Access**: Integrate Listmonk with other systems programmatically.
|
|
* **Multi-lingual**: Supports multiple languages.
|
|
|
|
## Documentation
|
|
|
|
For more detailed information about Listmonk, visit the [official documentation](https://listmonk.app/docs/).
|
|
|
|
## Getting Started with Listmonk
|
|
|
|
### Accessing Listmonk
|
|
1. **URL**: Access Listmonk locally via `http://localhost:9000/` (or your configured external URL).
|
|
2. **Login**: You will need to log in with the administrator credentials you configured during the Changemaker setup or the first time you accessed Listmonk.
|
|
|
|
### Basic Workflow
|
|
|
|
1. **Configure Mail Settings (Important First Step)**:
|
|
* After logging in for the first time, navigate to **Settings > SMTP**.
|
|
* You MUST configure an SMTP server for Listmonk to be able to send emails. This could be a transactional email service (like SendGrid, Mailgun, Amazon SES - some offer free tiers) or your own mail server.
|
|
* Enter the SMTP host, port, username, and password for your chosen email provider.
|
|
* Send a test email from Listmonk to verify the settings.
|
|
|
|
2. **Create a Mailing List**:
|
|
* Go to **Lists** and click "New List".
|
|
* Give your list a name (e.g., "Monthly Newsletter Subscribers"), a description, and choose its type (public or private).
|
|
* Set opt-in preferences (single or double opt-in).
|
|
|
|
3. **Import Subscribers**:
|
|
* Go to **Subscribers**.
|
|
* You can add subscribers manually or import them from a CSV file.
|
|
* Ensure you have consent from your subscribers before adding them.
|
|
* Map CSV columns to Listmonk fields (email, name, etc.).
|
|
|
|
4. **Create an Email Template (Optional but Recommended)**:
|
|
* Go to **Templates** and click "New Template".
|
|
* Design a reusable HTML or Markdown template for your emails to maintain consistent branding.
|
|
* Use template variables (e.g., `{{ .Subscriber.Email }}`, `{{ .Subscriber.Name }}`) to personalize emails.
|
|
|
|
5. **Create and Send a Campaign**:
|
|
* Go to **Campaigns** and click "New Campaign".
|
|
* **Name**: Give your campaign a descriptive name.
|
|
* **Subject**: Write a compelling email subject line.
|
|
* **Lists**: Select the mailing list(s) to send the campaign to.
|
|
* **Content**: Write your email content. You can choose:
|
|
* **Rich Text Editor**: A WYSIWYG editor.
|
|
* **Plain Text + Markdown**: Write in Markdown for simplicity and version control friendliness.
|
|
* **Use a Template**: Select one of your pre-designed templates and fill in the content areas.
|
|
* **Send Test Email**: Always send a test email to yourself or a small group to check formatting and links before sending to your entire list.
|
|
* **Schedule or Send**: You can schedule the campaign to be sent at a later time or send it immediately.
|
|
|
|
6. **Analyze Campaign Performance**:
|
|
* After a campaign is sent, go to **Campaigns**, click on the campaign name, and view its statistics (sent, opened, clicked, etc.).
|
|
|
|
## Further Information
|
|
|
|
For comprehensive details on all Listmonk features, advanced configurations (like bounce handling, API usage), and troubleshooting, please consult the [official Listmonk Documentation](https://listmonk.app/docs/).
|