Listmonk instructions are not good enough

Discuss
, , ,
1

I installed listmonk on maillist.example.org, following the instructions for listmonk, but they did not function.

The instructions:

Visit Settings → General and replace these values:

Root URL: https://maillist.example.org
Default from email: listmonk listmonk@maillist.example.org

Visit Settings → SMTP and replace with these values:

Host: localhost
Port: 25
Auth protocol: PLAIN
User: listmonk
Password: 5fd255299ef3fbcb896d0d22
HELO hostname: maillist.example.org

Then, test the connection

However, this does not work. You get following error:

SMTP AUTH extension not found

But, if you choose
Auth protocol: None

you may send testmail, IF you are logged in as listmonk. Else you get:

553 5.7.1 <listmonk@maillist.example.org>: Sender address rejected: not logged in

But, you may send a testmail if you have been logged in as admin and change:

Default from email: listmonk admin@maillist.example.org

Usually, you would not prefer to send from xxxx@maillist.example.org, but from xxxx@example.org. Hence, it is preferable to change to:

 Root URL: https://example.org
Default from email: listmonk admin@example.org

To conclude: It looks like the instructions are not good enough.

2

The app is open to PR to improve instructions

3

how?

4

I tried to use the “tip” but didn’t worked.
But, I not really checked how my Yunohost can send emails, because I have a server for emails.
I use Virtualmin on another VM, and I configured the “smtp” tab with the server smtp name, login and password. Worked fine

Of course, there is several tab to configure.

5

Listmonk seems to work, but it seems that postfix will not accept any “default from email” (settings > general). As to my experience it works with: some-name <noreply@your-domain> and Root URL: https://yourdomain. If you use a ‘wrong’ from-email (you may change some-name) then the logs (settings > log or /var/log/mail.log) will say “Sender address rejected: not logged in”. I haven’t trailed-and-errored enough to tell more exactly which from-emails are allowed.

6

Just installing this for the first time, and following the post install config.
Testing SMTP connection is failing, so further clarifications needed:

I’m assuming here that the post-install notes referencing listmonk@mysite.com means that I don’t need to manually create this address (yunohost user).

It also isn’t clear what settings should come after the HELO hostname.

With TLS set to STARTTLS, i get the following error

tls: failed to verify certificate: x509: certificate is valid for domain.tld, not localhost

If I set Host to mysite.com

535 5.7.8 Error: authentication failed: (reason unavailable)

With Host set to localhost and Skip TLS verification enabled, then I get:

451 4.3.0 listmonk@list.mysite.com: Temporary lookup failure

7

I have listmonk working… so we have added a user yunohost listmonk_sender with the mail listmonk_sender@list.domain.tld and in the dongle SMTP:

Host : list.domain.tld/ Port 587
PROTOCOL : Login / Name User : listmonk_sender /password : xxxxxxxxxxxxxxxxx
Name Host Hello : / TLS : STARTSSL

Max Nb connexion : 10 / resend tentatives : 2 / Delay inactivity : 15s / Delay queue : 5s

But is not for a big usage…

8

Be careful also if there a page to subscribe to newsletter, you could be attacked by spams robots… we have added a captcha, we have create an account with hcaptcha.com and in admin settings you can configure this account…

10

Hello all

Thank you for your contributions here, they got Listmonk working for me!

I did one additional step and will clarify important steps below, too:

  • log in to Listmonk using listmonk Super Admin user details provided after install
  • in listmonk admin panel, set:
  • host (mydomain)
  • port (587)
  • add admin user on Yunohost admin panel (newslettersender@mydomain)
  • add Super Admin user on Listmonk admin panel (newslettersender@mydomain) ie same credentials as on Yunohost admin
  • Enter details of this new user in:
  • Admin general settings > Default sender
  • SMTP settings > username and password
  • TLS (STARTTLS)

if you have different email addresses in the two different sections of admin, even if they are both Super Admin accounts and even if they are both Yunohost user admin accounts, it doesn’t work.

Also, if you aren’t logged in as the original admin user provided after install, it won’t work, even if you are logged in as another super admin user.

I am happy to put in PR in the documentation for updating instructions. Is there anything anyone wants to add though?

It would be lovely if one day these instructions are clear from many perspectives of different users.