From 6d8f06e85685b25f6c6bdc17676f8c36e67f21e6 Mon Sep 17 00:00:00 2001 From: Volker Theile Date: Wed, 26 Jun 2024 15:25:49 +0200 Subject: [PATCH] Improve description how to use Gmail Signed-off-by: Volker Theile --- administration/general/notifications.rst | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/administration/general/notifications.rst b/administration/general/notifications.rst index d9be4a8..3a503db 100644 --- a/administration/general/notifications.rst +++ b/administration/general/notifications.rst @@ -65,23 +65,28 @@ Options marked with [D] can be disabled selectively. The rest only when the whol Gmail ===== -Gmail can be used in notifications. If you have 2FA enabled for the account, then is necessary to create an `app password `_. Please use the following settings:: +Gmail can be used to send notifications, but only if you have enabled 2FA for your account. +The App-Password must then be used as the password in the settings page. You can manage your Google App-Passwords `here `_. + +Please use the following settings:: SMTP Server: smtp.gmail.com SMTP Port: 587 Encryption mode: STARTTLS - Sender email: rootthe@gmail.com (include domain) + Sender email: @gmail.com Authentication required: Yes - Username: rootthe@gmail.com (include domain) - Password: - Primary email: rootthe@gmail.com + Username: @gmail.com + Password: + Primary email: @gmail.com Secondary email: optional +You can use any email address as your primary address. It can, but does not have to be, the sender address. + .. note:: - Aliases are allowed. This is good for filtering later in gmail. ``rootthe@gmail.com`` can be ``rootthe+server1@gmail.com`` or ``rootthe+whatever@gmail.com``. + Aliases are allowed. This is good for filtering later in gmail. ``@gmail.com`` can be ``+server1@gmail.com`` or ``+whatever@gmail.com``. .. note:: - Google removed the "less secure apps" option on May 30, 2022. This means that there is no way to turn it on. An app password must be used as described above. + Google removed the "less secure apps" option on May 30, 2022. This means that there is no way to turn it on. An App-Password must be used instead as described above. Third Party Notifications