Skip to content

Commit 80b4a5b

Browse files
joshtrichardssusnux
authored andcommitted
feat(troubleshooting): add Internal Server Errors section
Signed-off-by: Josh <[email protected]>
1 parent 9fb405f commit 80b4a5b

File tree

1 file changed

+30
-10
lines changed

1 file changed

+30
-10
lines changed

Diff for: admin_manual/issues/general_troubleshooting.rst

+30-10
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,37 @@ different issues. Always disable 3rd party apps before upgrades, and for
5151
troubleshooting. Please refer to the :ref:`apps_commands_label` on how
5252
to disable an app from command line.
5353

54-
Nextcloud logfiles
55-
^^^^^^^^^^^^^^^^^^
54+
Internal Server Errors
55+
^^^^^^^^^^^^^^^^^^^^^^
5656

57-
In a standard Nextcloud installation the log level is set to ``Normal``. To find
58-
any issues you need to raise the log level to ``All`` in your ``config.php``
59-
file, or to **Everything** on your Nextcloud Admin page. Please see
60-
:doc:`../configuration_server/logging_configuration` for more information on
61-
these log levels.
57+
An Internal Server Error, sometimes called a "500 error", indicates that the web server
58+
encountered an unexpected condition that prevented it from fulfilling the request.
59+
60+
This error response is a generic "catch-all" response. To find out the source of the
61+
error you will need to check your Nextcloud log (located in `data/nextcloud.log` by
62+
default) and possibly your web server's error log (depending on where the failure is
63+
occurring).
64+
65+
.. tip:: Whenever possible, Nextcloud will include the "Request id" in the error. This
66+
request ID can be searched for in your Nextcloud log file to find entries associated
67+
with the failing transaction.
68+
69+
Nextcloud log files
70+
^^^^^^^^^^^^^^^^^^^
71+
72+
The Nextcloud log file is located in the data directory by default - e.g.
73+
``data/nextcloud.log``. If the Web UI is still reachable, it is also available
74+
via *Administration settings->Logging*.
75+
76+
.. tip:: When asking for help, the entire raw log entry is generally required.
77+
78+
.. note: In a standard Nextcloud installation the log level is set to ``2``. This is
79+
known as the ``WARN`` level. It is sufficient for catching for day-to-day problems
80+
(warnings, errors, and fatal errors).
81+
82+
For some situations you may need to adjust the log level in your ``config.php``
83+
file. Please see :doc:`../configuration_server/logging_configuration` for more
84+
information on these log levels.
6285

6386
Some logging - for example JavaScript console logging - needs debugging
6487
enabled. Edit :file:`config/config.php` and change ``'debug' => false,`` to
@@ -68,9 +91,6 @@ For JavaScript issues you will also need to view the javascript console. All
6891
major browsers have developer tools for viewing the console, and you
6992
usually access them by pressing F12.
7093

71-
.. note:: The logfile of Nextcloud is located in the data directory
72-
``nextcloud/data/nextcloud.log``.
73-
7494
.. _label-phpinfo:
7595

7696
PHP version and information

0 commit comments

Comments
 (0)