The steps to enable detailed error display in Omeka S are as follows. By making this setting, specific error messages and details will be displayed on the “Omeka S has encountered an error” page. Additionally, PHP-level errors and warnings will also be displayed on the page. This is intended to make it easier to identify and resolve issues during development, but for security reasons, it is recommended not to use this in production environments.

Steps to Enable Detailed Error Display

  1. Find the .htaccess file:

    • There is a .htaccess file in the main directory of the Omeka S installation folder. This file is used to customize web server settings.

  2. Edit the .htaccess file:

    • Open the .htaccess file with a text editor.
    • Find the following line in the file:
SetEnvAPPLICATION_ENV"production"
 * Change this line to the following:
SetEnvAPPLICATION_ENV"development"

  1. Save changes and restart the server:

    • After saving the changes, you may need to restart the web server. This depends on the server configuration.

With this change, Omeka S will run in “development” mode, and detailed information will be displayed when errors occur. This is very helpful for diagnosing and resolving problems, but since it also carries security risks, please do not use it in public-facing environments.