diff options
author | Christoph Wurst <christoph@winzerhof-wurst.at> | 2021-02-25 14:39:24 +0300 |
---|---|---|
committer | Christoph Wurst <christoph@winzerhof-wurst.at> | 2021-02-25 14:39:24 +0300 |
commit | c91418ad23d5c8e81bbec153b0787be74db8ca7c (patch) | |
tree | 64cc78a075b714554a0b5226067ad690895f398b /doc | |
parent | e365ee229ab913dfeb3ee3cc401c4061c2143ab0 (diff) |
Add logging section to admin docs
Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/admin.md | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/admin.md b/doc/admin.md index 56447c737..84986d3f8 100644 --- a/doc/admin.md +++ b/doc/admin.md @@ -41,6 +41,14 @@ Turn off TLS verfication for IMAP/SMTP. This happens globally for all accounts a ## Troubleshooting +### Logging + +The Nextcloud mail app offers an extensive logging system to make it easier identifying and tracking down bugs. + +Please enable [debug mode](https://docs.nextcloud.com/server/stable/developer_manual/getting_started/devenv.html#enabling-debug-mode) and set the log [level to debug](https://docs.nextcloud.com/server/stable/admin_manual/configuration_server/logging_configuration.html) in your admin settings. Then try to reproduce your issue and take another look at `data/nextcloud.log`, `data/horde_imap.log` and `data/horde_smtp.log`. + +Make sure to remove any sensitive data before posting it publicly. Reset log levels and debug mode to the previous values when you are done debugging. + ### Database insert problems on MySQL If Mail fails to insert new rows for messages (`oc_mail_messages`), recipients (`oc_mail_recipients`) or similar tables, you are possibly not using the 4 byte support. See [the Nextcloud Admin Manual](https://docs.nextcloud.com/server/stable/admin_manual/configuration_database/mysql_4byte_support.html) on how to update your database configuration. |