This guide explains how to update UCRM and how to switch from/to the beta branch of the UCRM project. The beta branch is intended to provide the user with the most recent UCRM features and improvements.
Table of Contents
In UCRM navigate to System > Tools > Update to upgrade to a new UCRM version. Choose whether you want to run UCRM from the stable branch (more reliable version) or from the beta branch (which has the most recent features) and click the "Update to this version" button.
Note that you will be notified about a new available version automatically once it’s released. An orange button reading "Update to new version" will be visible on all pages in UCRM.
Once you click "Update to this version" under Tools > Updates, the rest of the process is fully automated. All users: admins and clients, will see a splash screen informing them that UCRM is currently under maintenance. Once the update is done, you will be automatically redirected back to the system. If you want to see what’s new in the updated version, just click on the notification icon (top right-hand corner).
In some cases it might be helpful to see the log file of the latest update process. Go to see the update log file in the System > Tools > Updates or if the UI is not accessible, you can find this log file on the server at this location: /home/ucrm/data/ucrm/updates/update.log
Use this file when asking for help on the UNMS Community forum. Note that this file is overwritten each time you run the update either in-app update or manual update.
Manual Update Using CLI
In some non-standard situations you may need to run the UCRM update manually using CLI. The following command will update UCRM to the latest stable or the latest beta version depending on whether it is currently using the stable or beta branch.
curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UCRM/master/update.sh | sudo bash -s | sudo tee update.log
If you want to switch to a specific version, you just need to put the version number in the command. For example, this will update your UCRM to version 2.12.0-beta1
curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UCRM/master/update.sh | sudo bash -s -- 2.12.0-beta1 | sudo tee update.log