Retrieve Log Files and Configuration Settings


Generating configreports and preparing log files are essential to support identifying the cause of a problem. Here are instructions for how to collect them.

When you report a problem to ownCloud Support or our Forum (ownCloud Central) you will be asked to provide certain log files or configurations for our engineers or other supporting staff. This information is necessary in better understanding your issue, your specific configuration, and for further support.

Generate a Config Report

You can use the webUI or the command line to generate a config report. The webUI includes the web server environment, while the command line generated one doesn’t as it can’t access it. Therefore, if possible, always generate it through the webUI. The configreport app is always part of bundled apps, but it may need to be enabled before it can be used.

Check if it is disabled:

sudo -u www-data ./occ app:list --disabled configreport

Enable it if it was formerly disabled:

sudo -u www-data ./occ app:enable configreport

Generate via webUI

To generate a config report using the webUI, navigate to:
Settings  Admin  General  "Generate Config report"  "Download ownCloud config report".

Generate via Command Line

To generate a config report from the command line, run the following command from the root directory of your ownCloud installation:

sudo -u www-data ./occ configreport:generate > config_report.txt

ownCloud Server Log File

Generate via webUI

You can use the webUI to download your ownCloud Server log file. To do so, navigate to:
Settings  Admin  General  Log  "Download logfile".

Generate via Command Line

If the log file is too big, you will need to transfer it from the command line. The location of the log file can be found in your config.php. By default it is in your data directory. Note that you may need to compress the logfile before uploading:

'datadirectory' => '/var/www/owncloud/data',

When not using the default location for the logfile, it can be specified via:

'logfile' => '<your-path>/owncloud.log',

LDAP Config

If LDAP is used, viewing the LDAP configuration is important when checking for errors between your ownCloud instance and your LDAP server. To get the output file, execute this command:

sudo -u www-data ./occ ldap:show-config > ldap_config.txt