FileRun PHP Compatibility

PHP versionFileRun min versionFileRun max versionionCube min version
8.2 Not yet supported
8.1 2023.1.0 (May 2023) 12.0.1 (Released 2022-08-12)
8.0 Not supported
7.4 Any version starting with 2018.11.11 will run, but just enough for you to update. 2019.12.25 (December 2019) is the first one that is thoroughly tested to work great. 20220519 (May 2022) 10.4.0 (Released 2020-06-29)
7.3 2019.05.21 (May 2019) 10.2
7.2 2018.02.13 (February 2018) 20220202 (February 2022) 10.1
7.1 2018.02.13 (February 2018) 2021.06.27 (June 2021) 10.1
7.0 2016.11.07 (November 2016) 2018.11.11 (November 2018) 10.0
5.6 2018.02.13 (February 2018) 6.0
5.5 2018.02.13 (February 2018) 5.0
Even when running a compatible FileRun version, when upgrading PHP to a newer version, the FileRun installation might stop working, in which case you will need to apply the steps bellow.
⚠️ Important: This is a risky operation. If not careful you can loose your existing data. Please make a backup before starting making changes on your server.

The FileRun application files that are currently in use on your server were designed to be used with a specific PHP version. Upgrading PHP to a newer version will cause the FileRun installation to stop working. The solution is to replace the application files with a new set, from an appropriate FileRun installation package. This can be done before or after upgrading the PHP version. It makes no difference, as the FileRun installation would not be accessible either way. The FileRun version of the installation package which you'll be using needs to match the exact FileRun version which you are currently running.

To determine which FileRun version you are currently running, sign in as superuser, open the control panel and go to “Software update”.

If, for example, you are running version 2016.11.07 you will need the installation package named FileRun_2016_11_07_PHP7.zip. Note the “PHP7” part in the filename. The latest FileRun version can always be downloaded from our homepage, but if you wish to upgrade an older FileRun version and your license includes support service, contact us for receiving an appropriate installation package for your version.

Let's assume you are updating version 2016.11.07 and your FileRun installation is located inside /www/filerun/.

  1. Make a backup of your folder /www/filerun/. Preferably on an external storage.
  2. Create a subfolder /www/filerun/@old.
  3. Move everything from /www/filerun/ to the @old subfolder.
  4. Extract the archive FileRun_2016_11_07_PHP7.zip inside /www/filerun
  5. Rename the folder /www/filerun/system/data to something like _data_default. This folder is not needed, but don't delete it, just to make sure you are not deleting any wrong folder.
  6. Move the folder /www/filerun/@old/system/data (from the old installation) inside /www/filerun/system/. (This basically transfers over your settings and data.)
  7. Troubleshooting:
    1. If you are getting a licensing error, simply access http://YOUR-SITE.COM/filerun/?alicense=1&key=YOUR-FILERUN-LICENSE-KEY to update the license.
    2. If you are getting an error about the file “system/data/filetypes.php”, upload the file again from a FileRun zip archive that matches your version.
  8. After confirming that the installation is working fine, you can delete the remaining /www/filerun/@old subfolder.

And that's it. If you have upgraded PHP to the newer version, then the FileRun installation should also be up and running now.