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 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!)

  1. 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.
  2. Move the folder “system/data” (and any other file that you might have customized and the update did not overwrite) from the broken installation to a safe location.
  3. Delete the FileRun installation folder (after making sure you have the folder “system/data” in a safe location)
  4. Extract the contents of the FileRun installation kit mentioned at step #1, at the exact same location of your old installation. It is very important to have the application files in the same location as before and not in some other folder.
  5. Replace the newly extracted “system/data” folder with the old one, the one you saved to a safe location at step #2
  6. Access your FileRun installation using the browser and make sure things work as they used to, before installing the update.
  7. Make a backup of your now working FileRun installation and follow the above update installation guide, without skipping any step ;)