Updating FileRun

For Docker users: updating the Docker image will only update the FileRun server environment.

FileRun updates are installed from the installation's control panel.

Updates install one after the other and there is no way of skipping to the latest version while keeping your settings.

To install a FileRun update, please follow these steps:

  • Make a backup of the FileRun installation. This step is optional, but in the rare case something goes sideways during the update process, you will need this to get FileRun back online.
  • Access your FileRun installation and log in as superuser (The default login name of the superuser is admin or superuser).
  • Open Control panel and navigate to FileRun » Update (Software update in older versions)
  • If PHP will not be able to replace a file, because of its permission settings, the update will fail and the FileRun installation may become unusable. To avoid this, please try to set the permissions of the the entire FileRun installation folder so that PHP can replace all files without problems. You will be able to set the permissions back, after installing the update.
Make sure the MySQL user that FileRun is configured with, has temporary ALTER and DROP permissions. You can remove this permission after you are done with the updates.

1. Click Check for updates and wait while FileRun shows the result.

Read carefully the update's description and notes.

2. Click Download update and wait for the update to download.

3. Click Install update to install the update.

Read the update log carefully and check for error messages. If you encounter errors that you do not know how to fix, drop us a quick message.

If you are having troubles with file permissions on Linux servers, please contact your server administrator to help you make sure PHP has write access over the FileRun application files.

If you are using Microsft IIS web server, you need to right click the FileRun installation folder and add the system user “IUSR_<computer-name>” (Internet guest account) user to the list of users who have access to the folder, enabling the “Modify” and “Write” permissions.


You might also need to update the loaded translations.

If you have a backup of the FileRun installation folder, simply restore it, fix the problem indicated by the error in the update log, and try again.

If you ignored the advice about creating a backup, tried to install an update and failed, leaving your FileRun installation unusable, here are the steps to fix it:

(You can still make a backup of the broken FileRun installation folder and its database now, to avoid loosing your user accounts, settings and documents by mistake!)

You need a FileRun installation kit that matches the FileRun version you were last running, before it got broken. It is important that you have the exact same version, because you are going to replace the application files and these need to match the MySQL database structure. (We no longer make public installation kits for older FileRun versions. We can provide via e-mail request only to owners of Enterprise licenses with valid support service.)

Replacing FileRun application files

This guide is assuming your FileRun installation is installed inside /var/www/html/filerun.

1. Create the empty folder /var/www/html/broken (next to the filerun folder)

Linux command example:

mkdir /var/www/html/broken

2. Move everything from inside the old install folder /var/www/html/filerun to the newly created /var/www/html/broken folder.

Linux command example:

mv /var/www/html/filerun/* /var/www/html/broken/

3. Upload the FileRun installation zip archive inside the now empty /var/www/html/filerun, and extract it there. (If you are upgrading to the latest FileRun version, you can download the installation zip archive from your FileRun client account, under the specific license you will be using.)

Linux command example:

[/var/www/html/filerun]# unzip FileRun.zip

At this point, accessing the URL of your old FileRun installation in a browser should show the FileRun installation wizard of a brand new installation.

4. Rename the default data folder which was created from the zip at /var/www/html/filerun/system/data to anything else. (We use 'rename' or 'move' instead of 'delete', to avoid accidental data loss.)

Linux command example:

[/var/www/html/filerun/system]# mv data _data_renamed

5. Move the old data folder from the broken folder /var/www/html/broken/system/data to /var/www/html/filerun/system/data

Linux command example:

[/var/www/html/]# mv broken/system/data filerun/system/

At this point the FileRun installation should be restored. Confirm by accessing it in a browser.

6. Make a backup of your now working FileRun installation and follow the above update installation guide, without skipping any step ;)