Skip to main content

FAQ - 500 error or blank page

I get a “500” error or a blank page

A blank page indicates that two things happened:

  • A fatal error occurred while creating the web page.
  • Your web-server (e.g. apache, nginx, IIS) is configured not to display fatal errors on the screen.

Typical causes of fatal errors are:

  • File permissions. webtrees needs to be able to write to all the files and subfolders in the folder /data/
  • Running out of disk space. You can check if this is a problem by uploading (and then deleting) a large file to the server using FTP.
  • Running out of CPU time. You can identify these because the error does not appear until the time limit is reached.
  • Running out of memory. This can be caused by program errors or by trying to process a lot of data at once. For example, trying to list many thousand individuals at the same time.
  • Incompatible software. For example, using PHP 7.3 with software that was designed for PHP 7.4.
  • Trying to use a PHP function that has been blocked by your web-host. For example, the function needed to send mail can be blocked.

Generally when a fatal error occurs, the web-server will write a detailed error message to a log file. You need to find this error log. Without it, it will be very difficult to fix the problem.

Note that your web-server will produce two log files. One is the access log and the other is the error log. You want the error log.

If you cannot find your error log, you should contact your webhosting provider for assistance.

Windows IIS logs

Under a Windows IIS server, these logs contain detailed information about web requests and can be used to monitor traffic and troubleshoot issues. Default Location: By default, IIS logs are stored in the following directory: %SystemDrive%\inetpub\logs\LogFiles Site-specific folders: Inside the LogFiles directory, you will find a subfolder for each website, named W3SVCn, where n is the site’s ID. Confirm log location: To verify the exact path, use the IIS Manager:

  • Open IIS Manager on your Lightsail instance.
  • Expand the Sites folder and select your website.
  • Double-click the Logging icon in the main pane.
  • The Directory field will show the log file path.

Windows IIS HTTP.sys error logs

For errors that occur before a request reaches the IIS worker process (e.g., service unavailable or bad requests), you should check the HTTP.sys error logs. Default Location: These logs are located in the following directory: C:\Windows\System32\LogFiles\HTTPERR

Alternatively, if your server uses .htaccess files, try adding the following lines:

php_flag display_errors on
php_flag display_startup_errors on
php_value error_reporting -1

Edit this page