Update, recover and replace a UniFi Cloud Gateway
A Cloud Gateway does several jobs at once, so a bad update or a failed unit can take out your internet, WiFi and cameras together. This guide covers both halves of looking after one: updating it without surprises, and getting it back when something goes wrong. Recovery works best as a ladder, so start with the smallest fix and only move down when you have to.
Outcome and equipment
By the end, your gateway will update on your terms, you'll have a backup you can reach when the network is down, and you'll know what to do next at each stage of a failure.
- The Owner's UI account, and its MFA backup codes.
- A computer with a network port or USB adapter, and a short cable.
- A pin or straightened paper clip for the reset button.
- A phone on mobile data, because you'll want to look things up when your internet is down.
- A System Config backup file from Settings › Control Plane › Backups, saved somewhere other than the gateway. [1]
Know what gets updated
| Layer | What it is | Where to update it |
|---|---|---|
| UniFi OS | The gateway's operating system | Settings › Control Plane › Updates [2] |
| Applications | Network, Protect and Access | Settings › Control Plane › Updates [2] |
| Device firmware | Access points, switches and other UniFi devices | In the app that manages them, such as Network for access points and switches [2] |
We suggest updating UniFi OS first, then its apps, then your devices, because a new app version can need a newer UniFi OS. [3]
Not every gateway gets the same version. Network 11 needs UniFi OS 6.0 or newer. [3] In early November 2026, Ubiquiti released UniFi OS 5.1.35 and 6.0.17 for Dream Machines two days apart, so two versions were current at once. [4] [5] The newest Express 7 release we found was UniFi OS 5.2.9, and the original Express was on UniFi OS 4.0, with Network 9.0.122 released only for it. [6] [7] [8] Check what your gateway offers at Settings › Control Plane › Updates, and read the Network 11 upgrade guide before you change channels.
Choose your update settings
- Open the updates page. Go to Settings › Control Plane › Updates, then click the console or an application to see its options. [2]
- Stay on the Official channel. You choose between the Official and Early Access channels in the same settings. [2] Early Access is fine on a spare unit, but stick with Official for any network you rely on.
- Decide on auto-update. Automatic updates mean you get security fixes without having to remember. Ubiquiti's PCI guidance notes that UniFi supports them. [9] A busy site may prefer to update by hand, so the restart happens at a time you've picked. If you take that path, set a monthly reminder.
- Manage several sites from one place. Site Manager has an Update Manager for this. [2]
-
Check your backups. With System Backups ticked, the gateway backs up weekly and before each major update, to the Owner's account. [1] Only the Owner can manage these, and they're listed at
account.ui.com/backups. [1]
Update without surprises
- Read the release notes. Look for known issues on your model and anything that changes a feature you use.
- Save a backup. Download a copy from Settings › Control Plane › Backups, so you have it even without internet. [1]
- Choose a quiet time. A gateway restart takes the internet down for everyone, and recording stops if Protect runs on the same gateway.
- Update UniFi OS. Wait for it to come back fully.
- Update Network and your other apps. Do one at a time.
- Update your devices. Do access points in small groups, so you don't lose all your WiFi at once.
- Test. Check the internet, WiFi, VPNs and cameras, then leave it a day before you make any other changes.
Running two gateways? See Two gateways, no downtime: UniFi Shadow Mode before you update them.
Know your way back
You can usually step back one version, but don't rely on it. Check for these options on your own gateway before you need them.
| Layer | Can you go back? |
|---|---|
| UniFi OS | Community reports describe a Revert option on UniFi OS 5.1 and later, but we couldn't confirm the steps, so a backup is your real safety net. [10] |
| Network app | On Dream Machines, UniFi OS 5.1.11 added the ability to revert applications, and Network 10.2.105 added revert options to the update details on its dashboard. [11] [12] |
| Device firmware | Network 10.2.105 added an easy way to revert device firmware to previous versions. [12] To install a specific version, paste its firmware link into the Settings tab of the device's properties panel. [13] |
Work through recovery in order
Each step costs more than the last, so don't skip ahead.
| Step | Use it when | What it costs |
|---|---|---|
| 1. Check the basics | The internet or WiFi is down | Nothing |
| 2. Sign in locally | The app or cloud access isn't working | Nothing |
| 3. Restart | The gateway is stuck or slow | A few minutes of outage |
| 4. Factory reset | Settings are broken, or you can't sign in | All settings, until you restore |
| 5. Restore a backup | After a reset, or on a new unit | Changes since that backup |
| 6. Recovery Mode | Ubiquiti Support asks you to | All settings |
| 7. Replace it | The hardware has failed | Possibly your recordings |
Step 1: Check the basics
- Rule out the nbn. Check the lights on the nbn box or modem, and use your phone to look for an outage with your ISP.
- Check the power. Look at the display or status light, and try another outlet. On USB-C models, use the original adapter.
- Connect directly. Plug a computer into a LAN port. If it gets an address, the gateway's alive and the fault is more likely to be the WAN, a switch or a setting.
Step 2: Sign in locally
You don't need the internet to manage the gateway.
-
Use a browser. From a device on the LAN, go to the gateway's IP address or
unifi/. [14] - Or use the app. Choose Can't Find Your Device, then Console Manual Setup. [14]
- Sign in. Use a local admin account, or your UI account if Remote Management is on. [14] Secure a UniFi Cloud Gateway from day one shows how to create a local admin before you need one.
Step 3: Restart
Restart it from the interface if you can. If you can't, unplug the power, wait ten seconds and plug it back in. Give it several minutes, because the larger models take a while to start.
Step 4: Factory reset
A reset wipes the gateway's settings, so confirm you have a backup first. Assume recordings on the gateway may not survive it either, and export any footage you can.
- With the gateway powered on, press and hold the reset button for 5 to 10 seconds, until the LEDs signal a reset. [15]
- Let go. Holding it for too long can put the gateway into recovery instead. [15]
- Wait for it to restart and show that it's ready for setup.
If you can sign in, the Owner can also reset it from the UniFi OS system settings. [15]
Step 5: Restore a backup
- Start the setup. Sign in with the Owner's account, and choose to restore when you're offered it. On a running gateway, use Settings › Control Plane › Backups › Restore. [1]
- Pick a backup. Choose a cloud backup, or upload your backup file. [1]
- No internet? Ubiquiti says you can set UniFi up offline, without a UI account. [16] Then try restoring from the file at Settings › Control Plane › Backups. [1]
Back up and migrate a UniFi gateway covers this in more detail.
Step 6: Recovery Mode
This is the last resort. Ubiquiti says to use Recovery Mode only if its Support team asks you to, after a reboot and a factory reset have failed. It also resets the gateway to factory defaults. [17] The steps below come from that article and aren't split by model, so check with Support for yours.
-
Download the firmware. Get the current
.binfile for your exact model, before you start. [17] - Power it off. Unplug the gateway. [17]
- Enter Recovery Mode. Hold the reset button, plug the power back in, and keep holding for about 5 seconds, until the screen shows Recovery Mode on models with a display. [17]
- Connect your computer. Use LAN Port 1, or Port 18 on a Dream Wall. [17]
- Set a fixed address. Give your computer's network adapter the address 192.168.1.11 and mask 255.255.255.0. Leave the gateway and DNS blank, and turn off its WiFi if needed. [17]
-
Open the recovery page. Browse to
http://192.168.1.30. It works over HTTP only, so use another browser if yours forces HTTPS. [17] - Install the firmware. Choose Firmware Update, select the file, wait for it to finish, then reboot. [17]
- Put your computer back. Change its network adapter back to automatic, then set up the gateway and restore your backup.
Step 7: Replace it
- Check the warranty. Talk to the retailer you bought it from before you open the case or send it anywhere.
- Save what's on the drive. If the old gateway still starts, export any footage you need.
- Update the new unit. Set it up, update UniFi OS and Network, and restore your backup. [1] You can restore onto a different model if the new one runs UniFi OS 3.1 or newer. [1]
- Be careful moving to a very different model. Ubiquiti says a partial restore, with just the apps and settings you need, is especially useful when you restore to a different device. [1] Keep a note of your settings in case you need to enter them by hand.
- Don't reformat your drives yet. Ubiquiti says recordings can't be transferred between consoles. They stay on the original storage until you remove or reformat it, and a drive reused in the new gateway must be reformatted, which removes them. [1] Keep the old drive as it is until you've saved what you need, and ask Support first if the footage matters. Cameras start recording again on the new gateway. [1]
If you can't afford to wait for a replacement, keep a spare gateway on the shelf, or see Two gateways, no downtime: UniFi Shadow Mode.
Verification
- The updates page shows the versions you expect, on the channel you chose.
- A recent backup shows at Settings › Control Plane › Backups, and you have an offline copy.
- You've signed in with a local admin account at the gateway's LAN address.
- After any recovery, all devices show as Online, and a wired speed test matches your plan.
- Guest networks, firewall rules and port forwards behave as they did before.
- Protect is recording, and your cameras are all connected.
- Your computer's network adapter is back on automatic.
Troubleshooting and recovery
| Problem | Likely cause | What to do |
|---|---|---|
| An update isn't offered | It isn't on your release channel, or isn't available for your model or UniFi OS version [2] [3] [8] | Wait for it. Check the release notes before changing channels. |
| A device won't update | It's offline, or there isn't a newer version | Check it's online, then see Fix an offline UniFi AP or failed adoption. |
| Something broke after an update | A change in the new version | Read the release notes. Try the revert options above, then restore your backup if you need to. |
| You can't see your cloud backups | You're not signed in as the Owner [1] | Sign in with the Owner's account. |
| You've lost your MFA device | Your second factor isn't available | Use your backup codes, or sign in locally. See the security guide. |
| Reset did nothing | Button not held for long enough [15] | Hold it again for 5 to 10 seconds while the gateway's powered on. |
| Recovery page won't open | A static address problem, or HTTPS [17] | Recheck the address, turn off WiFi and type http:// in full. |
| A restored gateway has no internet | The backup's WAN settings don't suit the new setup | Check Settings › Internet. [18] |
| Devices stay offline after a restore | They're waiting for the old gateway | Give them a few minutes. If one stays offline or shows Managed by Another Console, factory reset it and adopt it again. [1] |
Sources:
- [1] Ubiquiti Help Center, Backups and Migration in UniFi.
- [2] Ubiquiti Help Center, UniFi Updates.
- [3] Ubiquiti Community, UniFi Network Application 11.0.83 release notes.
- [4] Ubiquiti Community, UniFi OS - Dream Machines 5.1.35.
- [5] Ubiquiti Community, UniFi OS - Dream Machines 6.0.17.
- [6] Ubiquiti Community, UniFi OS - Express 7 5.2.9.
- [7] Ubiquiti Community, UniFi OS - Express 4.0.22.
- [8] Ubiquiti Community, UniFi Network Application 9.0.122 release notes.
- [9] Ubiquiti Help Center, Ubiquiti UniFi PCI Compliance.
- [10] Ubiquiti Community, When should the revert option appear for OS and Network?.
- [11] Ubiquiti Community, UniFi OS - Dream Machines 5.1.11.
- [12] Ubiquiti Community, UniFi Network Application 10.2.105.
- [13] Ubiquiti Help Center, UniFi Advanced Updating Techniques.
- [14] Ubiquiti Help Center, UniFi Local Management.
- [15] Ubiquiti Help Center, How to Reset UniFi Devices to Factory Defaults.
- [16] Ubiquiti Help Center, How to Set Up UniFi.
- [17] Ubiquiti Help Center, UniFi Recovery Mode.
- [18] Ubiquiti Help Center, WAN Failover, Load Balancing and Port Remapping on UniFi Gateways.