Merge pull request #11451 from nextcloud/fix/admin-mail-debug

Fix(email_configuration): Fix conflicting debug mode sections
This commit is contained in:
Josh 2024-01-30 11:31:59 -05:00 committed by GitHub
commit 2180fa1c00
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -259,12 +259,24 @@ of the Admin settings page.
Troubleshooting
---------------
If you are unable to send email, try turning on debugging. Do this by enabling
the ``mail_smtpdebug`` parameter in ``config/config.php``.
Enabling debug mode
"""""""""""""""""""
If you are unable to send email, it might be useful to activate further debug
messages by enabling the ``mail_smtpdebug`` parameter and temporarily setting your NC loglevel to DEBUG:
::
"mail_smtpdebug" => true;
"mail_smtpdebug" => true,
"loglevel" => 0,
Be cautious setting your ``loglevel`` to DEBUG (``0``) since it'll apply to everything occurring on your NC instance, not just email.
And don't forget to set it back to a more reasonable level when you're done troubleshooting:
::
"mail_smtpdebug" => false,
"loglevel" => 2,
.. note:: Immediately after pressing the **Send email** button, as described
before, several **SMTP -> get_lines(): ...** messages appear on the screen.
@ -396,25 +408,6 @@ All emails keep getting rejected even though only one email address is invalid.
Partial sending, i. e. sending to all but the faulty email address is not possible.
Enabling debug mode
-------------------
If you are unable to send email, it might be useful to activate further debug
messages by enabling the ``mail_smtpdebug`` parameter and temporarily setting your NC loglevel to DEBUG:
::
"mail_smtpdebug" => true,
"loglevel" => 0,
Be cautious setting your ``loglevel`` to DEBUG (``0``) since it'll apply to everything occurring on your NC instance, not just email.
And don't forget to set it back to a more reasonable level when you're done troubleshooting:
::
"mail_smtpdebug" => false,
"loglevel" => 2,
.. note:: Immediately after pressing the **Send email** button, as described
before, several **SMTP -> get_lines(): ...** messages appear on the screen.
This is expected behavior and can be ignored.