Zum Inhalt

Listmonk

Was es tut

Listmonk verschickt Newsletter und Rundmails an Mitglieder und Interessierte und verwaltet die Listen der Empfängerinnen und Empfänger. Benutzt wird es nur von den Personen, die Newsletter schreiben.

Wo es liegt
Adresse https://listmonk.garage-lab.de
Host werner
Stack-Datei syslet/werner/stack-listmonk.cue
Begleitmaterial apps/listmonk/
Upstream listmonk.app, Doku

Verwaltet über

Beides. Container und Datenbank stehen in der Stack-Datei. Listen, Vorlagen, der Mailversand (SMTP) und die Anmeldung über Authentik werden in den Einstellungen von Listmonk selbst gepflegt.

Aufbau

  • listmonk-server ist die App; hochgeladene Bilder für Newsletter liegen im Volume listmonk-server-uploads.
  • listmonk-postgres ist die Datenbank mit Listen, Abonnements und Kampagnen.
  • listmonk-postgres-exporter liefert Messwerte der Datenbank für das Monitoring.

Beim Start richtet Listmonk die Datenbank selbst ein bzw. aktualisiert sie auf die neue Version.

Login / SSO

Angemeldet wird über Authentik per OIDC (application_listmonk.tf); die Gegenseite ist in den Einstellungen von Listmonk eingetragen. Zugang hat nur, wer in der Gruppe „Listmonk Access“ ist; neue Mitglieder kommen nicht automatisch hinein. Listmonk kann keine Rollen aus dem Login übernehmen und bekommt deshalb keine Gruppen.

Damit man nicht erst auf einen Knopf klicken muss, leitet ein kleines Skript in den Einstellungen von Listmonk die Login-Seite direkt zu Authentik weiter; es steht in apps/listmonk/admin-autologin.js. Listmonk selbst kann das nicht (Issue 2647). Mit ?skip_sso an der Adresse der Login-Seite kommt man an den Login ohne Authentik.

Backup

Gesichert werden ein Dump der Datenbank und die hochgeladenen Dateien (siehe Backup).

Updates

Die Version steht in image: listmonk: tag: oben in der Stack-Datei. Was sich ändert, steht in den Releases von Listmonk; vor jedem Update lesen (siehe Image-Version anheben). Weil Listmonk die Datenbank beim Start selbst auf die neue Version bringt, geht ein Schritt zurück auf die alte Version nur mit einem Restore.

Besonderheiten / bekannte Probleme

Weiterlesen