×

UniFi - UDM/UXG: Emergency Recovery Mode UI

Overview

Readers will learn how to access the Emergency Recovery Mode User Interface (UI) in order to factory reset, reboot, power off, or recover a UniFi Dream Machine (UDM or UDM-Pro) or UniFi Next-Generation Gateway Pro (UXG-Pro).

NOTES & REQUIREMENTS:
  • Applicable to the UniFi Dream Machine models (UDM/UDM-Pro) and UniFi Next-Generation Gateway Pro (UXG-Pro).
  • Only follow these steps if your device is not responding and the regular firmware upgrade process does not work.
  • Resetting the device to factory defaults through the Emergency Recovery Mode UI will wipe out any backup files. Download and save your backup configuration to a separate device before following this article.

Table of Contents

  1. Introduction
  2. Accessing the Emergency Recovery Mode UI using the Reset Button
  3. Related Articles

Introduction

The Emergency Recovery Mode User Interface (UI) is a special webpage that can only be accessed by holding the reset button on the UDM/UDM-Pro and UXG-Pro. From the Recovery Mode, you can perform the following actions:

  • Reset to Factory Defaults Completely reset the device. Note this will also wipe out any stored backup files.
  • Reboot Restart the device and re-load the existing configuration.
  • Poweroff Initiate a software shutdown on the device, after which you can safely remove the power cable.
  • Check Filesystems Check the integrity of the file system. 
  • Firmware Update Upload a previously downloaded firmware image (.bin) file in order to upgrade the firmware.
ATTENTION: Only follow these steps if your device is not responding and the regular firmware upgrade process does not work.

Accessing the Emergency Recovery Mode UI using the Reset Button

The images below show the location of the reset button on the UDM and UDM-Pro models:

udm-pro-topology.png

udm-topology.png

And the location of the reset button on the UXG-Pro:

uxg-pro-topology.png 

Follow the steps to access the Emergency Recovery Mode UI and upgrade the firmware:

UDM-Pro / UXG-Pro
UDM

1. Download the relevant UDM-Pro firmware file from the UniFi UDM-Pro Downloads section or the UXG-Pro firmware file from the Ubiquiti Community Software Releases section (Beta).

2. Completely power off the UDM-Pro / UXG-Pro and remove the power cable.

3. Press and hold the reset button and then power on the device by connecting it to the power source.

4. Keep the reset button pressed for 5 seconds, after some time the Touchscreen display will indicate that the UDM-Pro / UXG-Pro is in Recovery Mode.

UDM-Pro_recovery.png

5. Connect an Ethernet cable from your computer to the first LAN port on the UDM-Pro / UXG-Pro.

NOTE: On the UDM-Pro, the first LAN port (port 1) is located in the top-left corner. See the UDM QSG for more information on the port layout.

6. Configure a static IP address on your computer in the 192.168.1.0/24 range (for example 192.168.1.11).

 windows.png  Windows Client

Navigate to the Windows 10 Network connections.

Settings > Network & Internet > Status > Change Adapter Options

Modify the IPv4 settings of the Ethernet adapter.

Ethernet Adapter > Properties > Internet Protocol Version 4 (TCP/IPv4) > Properties

Select to manually enter an IP address and add the following information:

IP address: 192.168.1.11
Subnet mask: 255.255.255.0
Default gateway: <blank>
DNS servers: <blank>

windows.png

 macos.png  macOS client

Navigate to the macOS Network connections.

System Preferences > Networks > Ethernet Adapter

Select to manually enter an IP address and add the following information:

IP Address: 192.168.1.11
Subnet Mask: 255.255.255.0
Router: <blank>
DNS server: <blank>

macos.png

NOTE: If a wireless adapter is enabled and connected to another network it could conflict with the connection to the UDM-Pro / UXG-Pro. Disable the wireless adapter if necessary. 

7. Open a compatible web browser navigate to http://192.168.1.30 to access the Emergency Recovery Mode UI. 

udm-pro-recovery-ui.png

ATTENTION: The Emergency Recovery Mode UI is accessible via HTTP only and not HTTPS. It is possible that your browser will automatically try to redirect your session to HTTPS. Make sure to navigate to the http://192.168.1.30 address and use a different browser if necessary.

8. Select Firmware Update > Choose and browse your computer for the previously download firmware (.bin) image file.

9. Wait for the upgrade process to complete and reboot the device afterwards.

1. Download the relevant UDM firmware file from the UniFi UDM Downloads section.

2. Completely power off the UDM and remove the power cable.

3. Press and hold the reset button and then power on the device by connecting it to the power source.

4. Keep the reset button pressed for 5 seconds, after some time the fan on the UDM will turn off and the device will make a sound.

5. The LED pattern (white - white - blue - blue) will indicate that the UDM is in Recovery Mode.

6. Connect an Ethernet cable from your computer to the first LAN port (port 1) on the UDM.

NOTE: The first LAN port (port 1) is located at the top. See the QSG for more information on the port layout.

6. Configure a static IP address on your computer in the 192.168.1.0/24 range (for example 192.168.1.11).

 windows.png  Windows Client

Navigate to the Windows 10 Network connections.

Settings > Network & Internet > Status > Change Adapter Options

Modify the IPv4 settings of the Ethernet adapter.

Ethernet Adapter > Properties > Internet Protocol Version 4 (TCP/IPv4) > Properties

Select to manually enter an IP address and add the following information:

IP address: 192.168.1.11
Subnet mask: 255.255.255.0
Default gateway: <blank>
DNS servers: <blank>

windows.png

 macos.png  macOS client

Navigate to the macOS Network connections.

System Preferences > Networks > Ethernet Adapter

Select to manually enter an IP address and add the following information:

IP Address: 192.168.1.11
Subnet Mask: 255.255.255.0
Router: <blank>
DNS server: <blank>

macos.png

NOTE: If a wireless adapter is enabled and connected to another network it could conflict with the connection to the UDM. Disable the wireless adapter if necessary.

7. Open a compatible web browser navigate to http://192.168.1.30 to access the Emergency Recovery Mode UI. 

udm-recovery-ui.png

ATTENTION: The Emergency Recovery Mode UI is accessible via HTTP only and not HTTPS. It is possible that your browser will automatically try to redirect your session to HTTPS. Make sure to navigate to the http://192.168.1.30 address and use a different browser if necessary.

8. Select Firmware Update > Choose and browse your computer for the previously download firmware (.bin) image file.

9. Wait for the upgrade process to complete and reboot the device afterwards.

Related Articles

UniFi - How to Create and Restore a Backup

UniFi - How to Reset Devices to Factory Defaults

UniFi - UDM/UCK: How to Reset the UniFi Controller to Factory Defaults

Was this article helpful?
62 out of 144 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