Upgrading to a newer PHP version

⚠️ Important: This is a risky operation. If not careful you can lose 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 or Update (depending on the FileRun version).

If, for example, you are running version 2023.1.0 you will need the installation package named FileRun_2023.1.0_PHP-8.1.zip. Note the PHP-8.1 part in the filename. 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.

Step-by-step guide

Assuming your FileRun installation is located inside /www/filerun/.

  1. Make a backup of your FileRun installation folder (/www/filerun/).
    Preferably on an external storage.
  2. Create a subfolder named @old: /www/filerun/@old.
  3. Move everything from /www/filerun/ to the @old subfolder.
  4. Extract the archive FileRun_*.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. Move the folder /www/filerun/@old/customizables (from the old installation) inside /www/filerun/.
    This transfers over any advanced configuration that you might have made.
  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.