Notes & Limitations
- We recommend to run UniFi Network on a UniFi OS Console instead of a self-hosted setup.
- Running the UniFi Network application on a host machine/server is an advanced setup for those familiar with network administration.
- Unlike a UniFi OS Console, operating systems such as Windows and macOS are not optimized to run UniFi Network and you may encounter performance issues.
- Self-hosted setups cannot take advantage of enhanced features such as synchronizing backups with your UI account and streamlined remote access from the UniFi Portal.
Note: UniFi OS Consoles support both online setups with your UI account and offline setups with local administrators. For advanced users hoping for a scalable cloud-hosting approach, we also offer our own UniFi Cloud Console.
Install the UniFi Network Application on macOS
1. Verify that the Security & Privacy settings on macOS are set to App Store and identified developers.
2. Download the latest version of the UniFi Network application (UniFi.pkg) from the Download page.
3. Open the Finder, control-click the UniFi.pkg file and select Open.
4. Select Open if you get a malicious software warning.
- The Open option will only be shown if you control-click the UniFi.pkg file.
- Alternatively, select Open Anyway after a double-click in the macOS Security & Privacy settings.
5. Install the UniFi Network application.
6. Start the UniFi Network application and install Rosetta if prompted.
7. Ensure that any anti-virus/spyware programs and the macOS firewall are not blocking the application.
8. Open a browser, navigate to https://localhost:8443 and proceed when seeing the security warning.
9. Proceed to the setup.
Install the UniFi Network Application on Windows
1. Download the latest version of the UniFi Network application (UniFi-installer.exe) from the Download page.
- The latest versions of the UniFi Network application (7.3) require Java 11.
- Previous versions (7.2) use Java 8.
- Install only the x64 Java release and only one version of Java.
2. You will be prompted to install Java 11. Select the following options and download the x64 .msi file for Windows:
- Package Type: JRE
- Version: 11
3. Install Java, and set the Set JAVA_HOME variable to Will be installed on local hard drive.
4. After installing Java, continue the UniFi Network application installation and start it.
5. Ensure that any anti-virus/spyware programs and the Windows firewall are not blocking the application.
6. Open a browser, navigate to https://localhost:8443 and proceed when seeing the security warning.
7. Proceed to the setup.
Install the UniFi Network Application on Linux
Please see the Help Center article here.
Frequently Asked Questions
1. Does the UniFi Network application have to run at all times?
If the UniFi Network application is turned off, adopted UniFi devices (access points, switches) will keep functioning. |
2. Can I manage UniFi Devices that are adopted by another UniFi Network application?
No. The UniFi Network application installed on Windows/macOS/Linux is not a viewer for other UniFi Network applications (running on UniFi OS Consoles or other hosts). |
3. The UniFi Network application is running slow.
Verify if the host machine is capable of running the UniFi Network application. The more UniFi and client devices that are connected, the more resources that will be needed. |
4. The UniFi Network application is not able to start.
Verify if the host machine is capable of running the UniFi Network application and that the correct version of Java is installed. |
5. The UniFi Network application starts up, but I do not see any nearby UniFi devices.
Make sure that the firewall on the host machine is allowing the ports needed by UniFi and that the UniFi Network application is not blocked by any anti-virus/spyware programs. |
6. I'm getting a "Your connection is not private" warning when accessing via my browser.
This can be safely ignored. Proceed to the next page. |
7. What are the UniFi Network application system requirements?
At a bare-minimum, we recommend the following system requirements (make sure to read the Release Notes for more details about a particular version):
|