Troubleshooting

In 99% of the cases problems are caused by a server or PHP configuration problem. Checking the PHP error log for the error information should be the first course of action. The location of the PHP error log is defined in the PHP configuration using the directive error_log. If unsure about the PHP configuration, use the recommended settings.

The activity log

When an operation fail, in most cases there will be an associated log entry under the Activity logs control panel section. Selecting the record will show more details. Many times, if there is a system error (PHP, MySQL, or runtime error), it will be shown in there, so that you don't need to search other log files for more information. Double-clicking the record or using the View toolbar button, will open a new tab showing all details for that log entry.

PHP Error Log

If the FileRun installation works and the control panel is accessible, you can check the PHP error log from the System → PHP info → Error log tail. This shows only the last few pages of the log. To download the entire PHP error log, go to PHP info and click the link under the details column for the PHP error logging row.

Login loop

If the provided credentials are verified as correct, but you are being returned to the login page, make sure the path set in PHP's configuration for session.save_path points to a folder which exists and its permissions allow PHP to write data to it. Also make sure that your disk space is not full. Make sure that you are not trying to log in to FileRun via HTTP, while you have already logged in via HTTPS before that.

500 Internal Server Error (on Microsoft IIS servers)

Try removing the "web.config" file from the FileRun installation folder. Make sure the system user under which IIS is running has write permission over the folder "system/data" (and all its subfolders). Finally, enable detailed error reporting in the IIS configuration to get more information about the problem.

"The file ../index.php is corrupted."

Make sure PHP is configured with the latest ionCube version.

"MySQL: SQLSTATE[HY000] [2002] No such file or directory"

Try using 127.0.0.1 instead of localhost for the MySQL hostname.

Shared web links don't work (white page on XAMPP on Windows servers)

Make sure PHP is configured with include_path which contains .. For more details, please see: https://feedback.filerun.com/communities/1/topics/241-weblink-doesnt-work

Missing icons/fonts (Windows Server running IIS)

Your IIS server is not serving WOFF2 files correctly.

FileRun ships with a recommended.web.config file inside its root folder. Check that file out for an example recommended configuration for IIS. You can also try to simply rename that file to web.config.

Here's also a guide for older IIS versions.

Still having troubles?

If your server meets the requirements, the file permissions are correct, feel free to contact us.

Make sure you include the error message and a detailed and clear description of the problem. Screenshots are welcome.

For problems that are not related to installation, please use the client forum: https://feedback.filerun.com