Self-Hosting a UniFi Network Server
Self-hosting a UniFi Network Server should only be done by experienced network administrators. For the best and most streamlined experience, we recommend running UniFi Network on a dedicated UniFi Console compatible with UniFi OS. This will eliminate compatibility risks associated with third-party software and hardware.* Other benefits of UniFi Consoles include:
- Optimized hosting and management performance
- Automatic scheduling of backups and updates
- Seamless email and mobile push notifications for important system activity
*UniFi also offers the Cloud Key Enterprise (on-premise) and a native Cloud Console subscription for scaleable deployments managing hundreds of UniFi APs.
If you choose to continue, see below for instructions to install the UniFi Network Application on your device.
Instructions
Windows
Linux
macOS
- 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.
- 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
- Install Java, and set the Set JAVA_HOME variable to Will be installed on local hard drive.
- After installing Java, continue the UniFi Network application installation and start it.
- Ensure that any anti-virus/spyware programs and the Windows firewall are not blocking the application.
- Open a browser, navigate to https://localhost:8443 and proceed when seeing the security warning.
- Proceed with the setup wizard.
- Adopt your first UniFi device.
Please see the Help Center article here.
- Verify that the Security & Privacy settings on macOS are set to App Store and identified developers.
- Download the latest version of the UniFi Network application (UniFi.pkg) from the Download page.
- Open Finder, control-click the UniFi.pkg file and select Open.
- 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.
- Install the UniFi Network application.
- Start the UniFi Network application and install Rosetta if prompted.
- Ensure that any anti-virus/spyware programs and the macOS firewall are not blocking the application.
- Open a browser, navigate to https://localhost:8443 and proceed when seeing the security warning.
- Proceed with the setup wizard.
- Adopt your first UniFi device.
Frequently Asked Questions
However, it is highly recommended to keep the UniFi Network application running at at all times. This enables you gather accurate statistics and make configuration changes whenever needed.
If you are not able to keep the self-hosting Network Server running continuously, then we recommend to upgrade to a UniFi Console, which is optimized to run UniFi Network and other applications.
Please be aware that self-hosting the UniFi Network application is an advanced setup for those familiar with network administration. If you are experiencing poor performance, we recommend upgrading to a dedicated UniFi Console compatible with UniFi OS, which is optimized to run UniFi Network and other applications.
If you continue to experience issues, try installing the application on a different machine.
Please be aware that self-hosting the UniFi Network application is an advanced setup for those familiar with network administration. If you are unable to get the UniFi Network application running on your machine, we recommend upgrading to a dedicated UniFi Console compatible with UniFi OS, which is optimized to run UniFi Network and other applications.
Also make sure that the UniFi devices and the application are on the same network. If not, then remote adoption is required.
This can be safely ignored. Proceed to the next page.
- Operating system:
- Linux: Ubuntu Desktop / Server 22.04; Debian 11 "Bullseye"
- Windows: Windows 10; Windows Server 2016
- macOS: Mavericks 10.9, 10.10 Yosemite, 10.11 El Capitan, 10.12 Sierra, 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina.
- CPU: x86-64 Processor (Intel / AMD x64 Processors)
- RAM: 2GB
- Network: 100Mbps Wired Ethernet
- HDD: Minimum 10GB free (20GB or more preferred)
- Java: Java Runtime Environment (JRE) 11
- Web Browser: Google Chrome
- MongoDB: version 3.2 or later. Mongo is offered bundled: default is 2.4.14 (for macOS and Windows only).
Note: You will need to continually increase your system specs as you begin to adopt and manage more devices.