How to Update UniFi
Easily update UniFi through the Web Portal or Mobile App (iOS / Android). Ensure you use the latest versions to maintain optimal performance and benefit from the latest that UniFi has to offer.
There are three types of updates associated with UniFi:
- UniFi OS: Bundles together Application updates that are available at the time of release. Found and triggered in UniFi OS Settings.
- UniFi Application: Updates a specific application and its corresponding devices. Found and triggered in UniFi OS Settings.
- UniFi Device: Updates an individual device. Found and triggered in the device's respective application.
Automatic Updates
We highly recommend that users enable automatic updates. This is the easiest, most convenient way to ensure that your deployment stays up to date with no intervention necessary. Automatic UniFi OS and Application updates occur at 3 AM by default, but this schedule can be changed in your UniFi OS Settings.
Users with a Self-Hosted Network Server must manually initiate updates. This is one of many reasons that we recommend a UniFi Console to most users.
Troubleshooting Update Failures
We recommend following the below steps to identify the root cause of your failed update.
Advanced users may also opt to manually update via SSH. This advanced technique is not generally recommended, however a successful SSH update indicates the updating issue is one of the following.
IP Settings are Unable to Resolve our Update Servers
A device’s DNS server can be configured by navigating to the appropriate application > Devices > Select a device > Settings. Verify that the network’s DNS server is correctly configured:
- If you use a UniFi Gateway: We recommend keeping the "Auto" settings, and keeping the IP Configuration to "DHCP." This way, you will use the DNS server configured by your internet service provider.
- If you use a third-party gateway or configure a static IP address: We recommend testing with a common public DNS server, such as 1.1.1.1 or 8.8.8.8.
Management Network Does Not Have Internet Access
Management network connection issues are often caused by incorrectly configured traffic or firewall rules, or other external network factors (i.e., ISP modem issues, third-party firewall usage, antivirus software, etc.). Ensure that your network is not being incorrectly restricted, blocking UniFi updates.
Refer to Virtual Network Connectivity for more information.
Blocked Traffic or Closed Ports
Your network must have access to DNS and NTP services. Please ensure the following ports are open:
- DNS (TCP & UDP Port 53): Used to communicate with our update servers.
- NTP (UDP Port 123): Ensure that a device is configured with the correct date and time. This is required by the TLS security standard we use for encrypted communication with our servers.
Additionally, verify that no UniFi Network firewall rules or upstream devices (i.e., gateways, third-party firewalls, ISP modems, etc.) will restrict or prevent access to these ports. Our Ports Reference will provide you a comprehensive list of requirements.
If you’re unsure which port(s) should be opened, we recommend contacting your internet service provider.