Upgrade Notes for FileCloud 23.1 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 has been 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.