(ARCHIVED) UCRM v2 - Update Guide and Beta Branch Usage

This article has been archived.

This article is applicable to UCRM v2 and will not be updated further. Thenew version of CRM is now part of the UNMS platform, and help articles for that version can be found under the UNMS section. See this article on how to upgrade from UCRM to UNMS.


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. 

WARNING:Be advised that reverting back to an older  stable version is not possible. The user will only be able to update to a newer stable or beta version as it is released.

Table of Contents

  1. In-App Update
  2. Debugging
  3. Manual Update Using CLI
  4. Related Articles

In-App Update

Back to Top

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.


WARNING: You will be able to switch back to a stable version only after a newer version of UCRM is released. E.g. moving from 2.2.2-beta1 to stable will only be possible after version 2.2.2 or higher is released. However, you can update to a newer beta version by just running the usual update command (without specifying the version).

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).


Back to Top

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

Back to Top

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.

cd /home/ucrm
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

cd /home/ucrm
curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UCRM/master/update.sh | sudo bash -s -- 2.12.0-beta1 | sudo tee update.log

Related Articles

Back to Top

UCRM - Backup and Migration

Was this article helpful?
0 out of 0 found this helpful
Can't find what you're looking for?
Visit our worldwide community of Ubiquiti experts for more answers
Visit the Ubiquiti Community