Retrieve Log Files and Configuration Settings

Introduction

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:

docker compose exec owncloud occ app:list --disabled configreport

Enable it if it was formerly disabled:

docker compose exec owncloud 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:

docker compose exec owncloud occ configreport:generate > config_report.txt

ownCloud Classic Log File

Generate via webUI

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

Generate via Command Line

If the log file is too big, transferring it via the GUI may cause issues and you will need to do this from the command line. By default it is named owncloud.log and located at the Docker Volume <mount-point>/files.

The location of the logfile can be customized.

This setup requires a configuration with configuration keys. No environment variables are available. See the Important Configuration Notes documentation for details.
You must create a Docker Volume to make the configured path available to the host. 
'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:

docker compose exec owncloud occ ldap:show-config > ldap_config.txt