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 an Official UniFi Hosting subscription service 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

  1. Download and install the latest version of the UniFi Network application (UniFi-installer.exe) from the Download page.
    1. Note: MongoDB 3.6 is the minimum supported version and is automatically bundled with the download.
  2. Enable TCP Port 8080, TCP Port 8843, UDP Port 10001, and UDP Port 3478 on any local firewall (including Windows Defender) or antivirus software. See our Required Ports Reference to learn more.
  3. Start the newly installed UniFi Network application.
  4. Open a browser, navigate to https://localhost:8443, and continue if you see a security warning.
  5. Proceed with the setup wizard.
  6. Adopt your first UniFi device.

Please see the Help Center article here.

  1. Verify that the Security & Privacy settings on macOS are set to App Store and identified developers.
  2. Download and install the latest version of the UniFi Network application (UniFi-installer.exe) from the Download page.
    1. Note: MongoDB 3.6 is the minimum supported version and is automatically bundled with the download.
  3. Open Finder, control-click the UniFi.pkg file and select Open.
  4. Select Open if you get a malicious software warning.
macos.png
    1. If unable to launch UniFi Network, navigate to your Apple menu > System Settings > Privacy & Security and select Open Anyway (you may need to scroll down).
  1. Follow the UniFi Network application installation process and start it. If prompted, install Rosetta as well.
  2. Enable TCP Port 8080, TCP Port 8843, UDP Port 10001, and UDP Port 3478 on any local firewall or antivirus software. See our Required Ports Reference to learn more.
  3. Open a browser, navigate to https://localhost:8443 and proceed when seeing the security warning.
  4. Proceed with the setup wizard.
  5. Adopt your first UniFi device.

Running as a Windows Service

Some advanced users may want to run the UniFi Server as a Windows service. To do so, follow the instructions 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. 

However, it is highly recommended to keep the UniFi Network application running 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.
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 Consoles).
3. The UniFi Network application is running slow.
Verify if the Self-Hosted Network Server is capable of running the UniFi Network application. The more UniFi and client devices that are connected, the more resources that will be needed.

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.
4. The UniFi Network application is not able to start.
Verify if the Self-Hosted Network Server is capable of running the UniFi Network application and that the correct version of Java is installed. 

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. 
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.

Also make sure that the UniFi devices and the application are on the same network. If not, then remote adoption is required.
6. I get 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):
  • 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 is no longer required as of UniFi Network 7.5
  • Web Browser: Google Chrome
  • MongoDB: version 3.6 or later. Mongo is offered bundled: default is 3.6 (for macOS and Windows only).

Note: You will need to continually increase your system specs as you begin to adopt and manage more devices.

Was this article helpful?
3283 out of 6128 found this helpful