×

UniFi - How to Migrate from Cloud Key to Cloud Key or UDM

Overview

This article describes how to export your UniFi Network Controller from one UniFi device to another. It is applicable for UniFi Network Controller migrations regardless of type of host: between Cloud Keys of different generations, same generation, from Cloud Keys to UniFi Dream Machines, etc. 

NOTES & REQUIREMENTS: Please upgrade both host devices involved to the latest version available, as well as the UniFi Controller Software. It is recommended to create a backup of your current Controller before beginning.

Table of Contents

  1. Introduction
  2. How to Migrate with Backup and Restore
  3. Troubleshooting Duplicate Controllers
  4. Troubleshooting Incompatible Versions
  5. Related Articles

Introduction

Back to Top

The Controller migration procedure is the same regardless of the device used (UCK or UDM), Cloud Key generation or method of hosting the Controller, as long as the new Controller version (the one you will be migrating to) is the same or newer than the original Controller's. 

How to Migrate with Backup and Restore

Back to Top

Follow these steps to download a backup of the original Cloud Key's Controller and migrate it to a new Cloud Key. The Backup and Restore method will migrate settings and historical data (if selected), as well as all sites and devices. 

NOTE:You will only be able to restore the backup on a device with a Controller version that is the same or newer than the one original host. You will be able to upgrade your new Cloud Key or UDM even before you adopt it from the Cloud Access Portal page. If you happen to be running a beta version on the original Cloud Key Controller, then upgrade the new Cloud Key's Controller via SSH. On a new Cloud Key or UDM, where you haven't set your own password, use root as username and ubnt as password for SSH access.

1. In the original Cloud Key's UniFi Network Controller go to Settings > Backup > Backup / Restore section (or in new settings: Settings > Backup > Backup / Restore). Use the drop down to modify the data retention to include historical data, or only save your Settings before downloading, then click Download to generate and save a new UniFi backup file (.unf). 

settings.controller_settings.backup.backup_restore.png

2. To avoid having duplicate Controllers shut down the old Cloud Key once the backup download is complete. Scroll down in the Controller Settings > Maintenance > Cloud Key Operations and click the Shut Down Cloud Key button.

Settings.Maintenance.CloudKeyOperations.ShutDownCloudKey.png

3. The backup can be uploaded to the new host in two different ways: either by setting up the new device first (use this method when migrating to a UniFi Dream Machine); or by starting the Setup Wizard and selecting "Restore from a previous backup" option. Both methods are described below.

Method 3A: Setting Up Host Device First (for UniFi Dream Machines)

Set up the new device as you usually would, following initial setup instructions and installing a new Controller instance. Once installed, in the new controller go to Settings > Controller Settings > Backup > Backup / Restore and click Choose File (or Settings > Backup > Backup / Restore in classic settings view). Select your recently downloaded .unf file. Note that this will also restore the Controller credentials from your original Cloud Key. 

After the system has restored all configurations, it might appear as a duplicate and with the same host IP address as the old controller's in the Cloud Access Portal. Use the one that is online to launch the controller. Skip down to step 4.

Method 3B: Using the Startup Wizard to Restore

Set up the new device as you usually would, following initial setup instructions. Launch the Setup Wizard by discovering the new Cloud Key and then clicking Adopt in the Cloud Access Portal.

Once the Setup Wizard launches, the first page will offer the option to restore from a previous backup. Click that link and select your recently downloaded .unf file. Note that this will also restore the Controller credentials from your original Cloud Key. 

startup_wizard.restore_setup.png
4. Wait until the backup is restored. Once UniFi finishes working, you will be presented with the login screen for the new Controller. Remember to use the username and password from the old Controller. 
Login_Screen.png

5. Once you have confirmed that all devices and settings have migrated successfully to the new Cloud Key, it is strongly recommended to reset the old Cloud Key to factory defaults to avoid duplicate Controllers if it is ever connected again. To reset the old Cloud Key follow these steps:

  1. Connect the old Cloud Key to power. Press and hold the reset button for 10 seconds.
  2. Release the button (the LED on the device will stop glowing).
  3. Do not disconnect the Cloud Key from its power source during the reboot process.
  4. The Cloud Key will restore factory settings.

6. Close the browser page with the Cloud Access Portal from where you launched the Controller Wizard. To open the Cloud Access Portal again, go to Settings > Remote Access and click the Dashboard link from there.

Troubleshooting Duplicate Controllers

Back to Top

Disconnected Devices After Migration

If after migrating the controller to its new host, the devices appear as disconnected in the Devices section, it could mean there is a duplicate controller issue, or that the devices are still adopted by the old controller.

Disconnected_devices.png

To verify, log into the UniFi Cloud Access portal using your Ubiquiti SSO account: https://network.unifi.ui.com/ and see how many controllers appear listed.Networks_account.pngIf you see something similar to the image above, where both controllers are still listed, it probably means both controllers are running on the same LAN, at the same time. This will create an adoption failure and other connectivity issues.

To address this, physically disconnect the host of the old controller to make sure there is no confusion. Refresh the new controller and after a moment, the old controller should disappear from the UniFi Cloud Access Portal list, and the devices in the new controller should begin to appear as adopted. Please see the articles below for more troubleshooting help.

UniFi Mobile App Warning: Controllers with Same UUIDs

For cases where the error "Controllers with Same UUID" is seen, please follow these instructions to solve:

1. Remove and disable Cloud Access under Settings > Remote Access > Disable and Remove Cloud Access.

2. Forget both controllers from the Cloud Access Portal list, by clicking on Forget on each controller row.

3. Enable and reconfigure Cloud Access once again in Settings > Remote Access.

4. Rename the new controller to make sure it is not confused with the old one in Settings > Controller > Controller Name.

Troubleshooting Incompatible Versions

If you cannot upgrade both Controllers to the same, latest version available this will cause the backup to fail. If upgrading via the usual methods is not possible, please create a topic on the Community's UniFi Routing & Switching section and tag (@mention) UI-Glenn so he can provide the correct method to perform this upgrade.

Related Articles

Back to Top 

UniFi - Advanced Adoption of a "Managed By Other" UAP

UniFi - Troubleshooting Offline Cloud Key and Other Stability Issues

UniFi - Controller FAQ

UniFi - How to Create and Restore a Backup

Was this article helpful?
22 out of 32 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