ListMonk installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(→‎Links: Kategorie Newsletterversand hinzugefügt)
 
(3 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
== ListMonk ==
== ListMonk ==
ListMonk [https://listmonk.app/] ist ein Newsletter und Mailinglisten-Manager zum Selbsthosten, und steht unter der Open Source Lizenz AGPLv3.
ListMonk [https://listmonk.app/] ist ein Newsletter-Manager zum Selbsthosten, und steht unter der Open Source Lizenz AGPLv3.


Monk hat in diesem Fall nichts mit einem Mönch zu tun, sondern ist eine versteckte Anspielung auf Monkey, da ListMonk eine Alternative zu MailChimp (Chimpanse) ist.
Monk hat in diesem Fall nichts mit einem Mönch zu tun, sondern ist eine versteckte Anspielung auf Monkey, da ListMonk eine Alternative zu MailChimp (Chimpanse) ist.
'''Achtung:''' Listmonk wirbt damit, [https://github.com/knadh/listmonk/blob/master/README.md Newsletter- und Mailinglisten-Manager] zu sein. Laut [https://github.com/knadh/listmonk/issues/1355 Fehlerbericht] ist das Tool aber lediglich für Einweg-Kommunikation (Newsletter) vorgesehen.


== Zur Technik ==
== Zur Technik ==
Zeile 14: Zeile 16:
Die Installation ist recht einfach: https://listmonk.app/docs/installation/
Die Installation ist recht einfach: https://listmonk.app/docs/installation/


* Das Programm muss heruntergeladen werden.
* Das Programm beispielsweise [https://github.com/knadh/listmonk/releases auf Github herunterladen] und entpacken
* Vorher den Hostsharing Service um eine freie Port Nummer fragen.
* Vorher den Hostsharing Service um eine freie Port Nummer fragen.
* Mit Monit wird das Programm als Dienst gestartet.
* Eine Datenbank anlegen
* Mit [[systemd]] wird das Programm als Dienst gestartet. Hierzu wird das Verzeichnis <code>~/.config/systemd/user/</code> erstellt und eine .service Datei angelegt:
 
<syntaxhighlight lang="ini" line>
[Unit]
Description=Listmonk
 
[Service]
Type=simple
Restart=on-abort
WorkingDirectory=/home/pacs/xyz00/users/newsletter
# --config mit vollständigem Pfad zum Configfile falls nicht im WorkingDirectory
ExecStart=/home/pacs/xyz00/users/newsletter/bin/listmonk
 
[Install]
WantedBy=default.target
</syntaxhighlight>
 
* Start und aktivieren von Autostart mittels <code>systemctl enable --now --user listmonk</code>
* Beispiel Webserver--Konfiguration unter <code>doms/meine-domain/htdocs-ssl/.htaccess</code>
 
<syntaxhighlight lang="apache" line>
DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RequestHeader set X-Forwarded-Proto "https"
# Port entsprechend der config.toml nach Absprache mit Service s.o.
RewriteRule ^(.*) http://127.0.0.1:9000/$1 [proxy,last]
</syntaxhighlight>


=== Installation mit Ansible Skript ===
=== Installation mit Ansible Skript ===
Es gibt ein Ansible Skript für Hostsharing [https://github.com/tpokorra/Hostsharing-Ansible-ListMonk], das die Installation automatisiert vornimmt, und schon den SMTP und POP Zugang konfiguriert.
Es gibt ein Ansible Skript für Hostsharing [https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/listmonk], das die Installation automatisiert vornimmt, und schon den SMTP und POP Zugang konfiguriert.


Dort kann man sicherlich auch Feinheiten der Installation abschauen, wenn man ListMonk manuell installieren will.
Dort kann man sicherlich auch Feinheiten der Installation abschauen, wenn man ListMonk manuell installieren will.
Zeile 38: Zeile 70:
* https://listmonk.app/ Projektseite
* https://listmonk.app/ Projektseite
* https://github.com/knadh/listmonk ListMonk auf Github
* https://github.com/knadh/listmonk ListMonk auf Github
* https://github.com/tpokorra/Hostsharing-Ansible-ListMonk Ansible Skript für Hostsharing von Timotheus Pokorra
* https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/listmonk Ansible Skript für Hostsharing von Timotheus Pokorra


----
----

Aktuelle Version vom 12. Juni 2024, 11:23 Uhr

ListMonk

ListMonk [1] ist ein Newsletter-Manager zum Selbsthosten, und steht unter der Open Source Lizenz AGPLv3.

Monk hat in diesem Fall nichts mit einem Mönch zu tun, sondern ist eine versteckte Anspielung auf Monkey, da ListMonk eine Alternative zu MailChimp (Chimpanse) ist.

Achtung: Listmonk wirbt damit, Newsletter- und Mailinglisten-Manager zu sein. Laut Fehlerbericht ist das Tool aber lediglich für Einweg-Kommunikation (Newsletter) vorgesehen.

Zur Technik

ListMonk ist in Go geschrieben, und wird als ein einziges Binary (Programm) installiert. Man muss im Shared Webspace bei Hostsharing einen Service dazu buchen, oder man setzt es auf einem Managed Server von Hostsharing ein.

Im Hintergrund wird PostgreSQL als Datenbank benutzt.

ListMonk bietet Anmeldungen per Double-Opt-In, und es gibt auch eine API für die Integration mit CRM/ERP Systemen (https://listmonk.app/docs/apis/apis/).

Zur Installation

Die Installation ist recht einfach: https://listmonk.app/docs/installation/

  • Das Programm beispielsweise auf Github herunterladen und entpacken
  • Vorher den Hostsharing Service um eine freie Port Nummer fragen.
  • Eine Datenbank anlegen
  • Mit systemd wird das Programm als Dienst gestartet. Hierzu wird das Verzeichnis ~/.config/systemd/user/ erstellt und eine .service Datei angelegt:
[Unit]
Description=Listmonk

[Service]
Type=simple
Restart=on-abort
WorkingDirectory=/home/pacs/xyz00/users/newsletter
# --config mit vollständigem Pfad zum Configfile falls nicht im WorkingDirectory
ExecStart=/home/pacs/xyz00/users/newsletter/bin/listmonk

[Install]
WantedBy=default.target
  • Start und aktivieren von Autostart mittels systemctl enable --now --user listmonk
  • Beispiel Webserver--Konfiguration unter doms/meine-domain/htdocs-ssl/.htaccess
DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RequestHeader set X-Forwarded-Proto "https"
# Port entsprechend der config.toml nach Absprache mit Service s.o.
RewriteRule ^(.*) http://127.0.0.1:9000/$1 [proxy,last]

Installation mit Ansible Skript

Es gibt ein Ansible Skript für Hostsharing [2], das die Installation automatisiert vornimmt, und schon den SMTP und POP Zugang konfiguriert.

Dort kann man sicherlich auch Feinheiten der Installation abschauen, wenn man ListMonk manuell installieren will.

Zur Bedienung

Hier ist ein Bildschirmfoto zur Einrichtung von SMTP für den Versand der E-Mails:

ListMonk SMTPSetup.png


Hier ist ein Bildschirmfoto zur Generierung des Formulars zur Anmeldung für einen Newsletter:

ListMonk SubscriptionForm.png

Links