Upgrade Notes for FileCloud 23.232 or Later

Backwards Compatibility Notes

You cannot upgrade Windows and Linux using the Admin Portal.

Beginning with Version 21.1, the files to download when upgrading with the Windows Update Tool have changed. The new files are listed below under Upgrade for Windows and with the full upgrade procedure in the documentation page Upgrade using Update Tool (Windows Only)


As always, make a full backup of your existing installation before upgrading.

If your installation of FileCloud uses admin portal user access restrictions, please see Restricting Access To Admin UI Based On IP Addresses for updated instructions.

Upgrade instructions for Windows

For all upgrades, once upgrade is complete, refresh the browser using CTRL-F5 to clear any prior setup information from the cache.

You can use the Windows Upgrade tool to do a full upgrade.

Windows Update Tool

Beginning with FileCloud 21.1, there are new files to download which are listed in the updated steps 1-3 of the upgrade procedure, below.

  1. Download the FileCloud Windows Update Tool from https://patch.codelathe.com/tonidocloud/live/installer/cloudupdatetool.zip

  2. Extract all files from cloudupdatetool.zip into a folder. 

  3. Download the following files and copy them to the extracted folder (the cloudupdatetool folder)

       Now, go to Upgrade using Update Tool (Windows Only) and proceed from Step 4.

Upgrade instructions for Linux

Upgrading FileCloud from 23.1.x to the latest version

To upgrade FileCloud from 23.1.x to the latest version in Linux see Upgrade FileCloud on Linux from Version 23.1 or 23.232 to the Latest FileCloud Version.

Upgrading FileCloud from 22.1 in Ubuntu 20.04 and RHEL 8

You can either re-install FileCloud or upgrade both FileCloud and your operating system.

Option 1:  Install one of the supported operating systems, then Install the latest version of FileCloud on the newly installed operating system, and then migrate FileCloud to the newly installed operating system. This is the recommended option. 

Option 2:   Perform a FileCloud upgrade which requires OS upgrades to Ubuntu 22.04 or RHEL 9.x, For this procedure, please Contact FileCloud Support
Please note that FileCloud Support cannot resolve OS upgrade problems. 

Upgrading FileCloud from versions lower than 22.1

If you are upgrading from a version of FileCloud lower than 22.1 or from an operating system below Ubuntu 22.04 LTS or RHEL 9, please install one of the supported operating systems, then Install the latest version of FileCloud on the newly installed operating system, and then migrate FileCloud to the newly installed operating system.

To upgrade systems running ServerLink, the following steps should be taken:

  1. Before upgrade, ensure all ServerLink nodes are fully synced and are at the same state.
  2. Make backups of all nodes as needed
  3. Upgrade the primary node first.
  4. Upgrade each secondary node after upgrading the primary node.
  5. Start up all nodes

FC Push Service Configuration

In FileCloud version 23.1, a Push service was added to allow clients (in particular, FileCloud Desktop) to receive server-initiated notifications (for example, file upload, share). Upgrading to FileCloud 23.1 or higher on systems running with MongoDB replica set or standalone MongoDB require the push service env file to be updated based on the MongoDB configuration.

To configure the Push service in Linux:

  1. Open and edit the .env file from path: /opt/fcpushservice/

    vi /opt/fcpushservice/.env
  2. Update the MongoDB connection string:

  3. Restart the fcpushservice.

    systemctl restart fcpushservice
To configure the Push service in Windows:

  1. Open the file xampp\pushservice\.env for edit.
  2. Update the MongoDB connection string to:

    FCPS_DB_DSN=mongodb://dbuser:passw0rd1@ dbserver01, dbserver02, dbserver03:27017
  3. Restart the Push service in the FileCloud control panel.

Upgrade environments using Solr and Solr+OCR


  1. Upgrade FileCloud
  2. Upgrade OpenJDK to version 11.
    1.  Download Open JDK 11.02+9 from https://jdk.java.net/archive/.
    2. Create a new folder in the C: drive.
      (In the example screenshot, jdk-11.0.2 is the name of the new folder.)
    3. Extract the Open JDK file you downloaded into the new folder.
  3. Set JAVA_HOME to the new version's path.

    Setting the path and environment variables will differ depending on the version of Windows you have on your computer. These instructions were designed for Windows 11.

    (warning)  Administrator privileges are required to modify the path and environment variables.

    To set the JAVA_Home path:

    1. Open the Windows Control Panel.
    2. Enter environment variables in the search bar.
    3. Click Edit the system environment variables.

    4. In the System Properties dialog box, click Environment Variables.

      The Environment Variables dialog box opens.
    5. In the System variables box, Click JAVA_HOME, and then click Edit.
      The Edit System Variable dialog box opens.
    6. Change Variable value to the address of the folder you created for jdk, and click OK.
    7. In the Environment Variables dialog box, click OK.
  4. Log in to the FileCloud admin portal.
  5. In the FileCloud Control Panel, and stop and restart Content Search.


  1. Upgrade FileCloud.
  2. Run:
    filecloudcp --install-solr
  3. If OCR is enabled, run:
    filecloudcp -t
  4. Log in to the FileCloud admin portal.
  5. Restart Solr.
    systemctl restart solr