Support Downloads Community

UniFi Video is an obsolete product line.

This application and its related devices will no longer receive any manner of technical support, including functional and security updates. Additionally, there will be no further updates to Help Center content pertaining to UniFi Video.

UniFi - Self-host the Network Application

The UniFi Network application is pre-installed on UniFi Dream Machines (UDM and UDM-Pro) and UniFi Cloud Keys (UCK Gen2, UCK Gen2 Plus and UC-CK), so no manual installation is necessary. We recommend using one of these consoles for one-step setup and to get the most out of UniFi Network.

Alternatively, you can download and host the Network application software yourself on a local device or a server.

This article describes how to install, configure, and manage the UniFi Network application to self-host your UniFi Network.

Host the UniFi Network application yourself

First, you'll need to install the software version for your platform. Make sure to meet system requirements before you begin.


1. Download UniFi Network software for Windows

You can find the latest software version for Windows on our Software Downloads page.

2. Run the installer

Install the software by running the installer and following the setup steps.

If you encounter a "This application requires Java" error, download and install Java 8 before re-running the installer.


3. Launch the UniFi Network application

Launch the UniFi application from the Start menu if it does not start automatically.

You will see a success message indicating the application has started and proceed to start configuring it via your browser by clicking "Launch a Browser to Manage the Network".

unifi-controller-setup-windows-initializing.png     unifi-controller-setup-windows-started.png


1. Download UniFi Network software for macOS

You can find the latest software version for macOS on our Software Downloads page.

2. Run the installer

Install the software by opening the UniFi.pkg file and following the setup steps.

If you receive a message that says "UniFi.pkg can't be opened because Apple cannot check it for malicious software" adjust your security settings.


3. Launch the UniFi Network application

Launch the UniFi application from the Applications folder if it does not start automatically.

You will see a success message indicating the application has started and proceed to start configuring it via your browser by clicking "Launch a Browser to Manage the Network".

If you encounter a "Unable to load Java Runtime Environment", download and install Java 8 before re-running the installer.


1. Open a shell connection with the UniFi Network host

SSH or open a console to the UniFi Network application host.

Switch to the /tmp/ directory with the command cd /tmp/.

2. Copy the download link for the UniFi Network software for Debian/Ubuntu Linux

You can find the latest software version for Debian/Ubuntu Linux on our Software Downloads page.

Copy the URL.

3. Download the software

Download the .deb software file with wget followed by the link you copied from the Downloads page.


4. Install the software

After the download completes, use sudo dpkg -i unifi_sysvinit_all.deb to unpack the .deb file and install the application.

If an error about missing dependencies is received, input the command sudo apt-get install -f to solve.

5. Installation complete!

After the process completes the command prompt will return to entry. The application software should be installed successfully at this point.

Some useful commands:

  • To start UniFi if the webpage prompt does not appear: sudo service unifi start
  • To stop the UniFi service: sudo service unifi stop
  • To restart the UniFi service: sudo service unifi restart
  • To see the status of UniFi service: sudo service unifi status


Configure the UniFi Network application

For UniFi OS Consoles the process of setting up the device will include setting up the application, so you only need to launch the application and adopt your connected devices. This section only applies if you are using a software install or an older Network version. You can access the configuration page at any time by typing https://<IP_of_Network_Application_host>:8443 into the navigation bar of a browser.

1. Name your Network instance

Specify the name for your UniFi Network instance to make it easier to identify it when managing multiple networks.


2. Sign in with your Ubiquiti Account

You will need to sign in with your Ubiquiti Account you will use to manage your application. If you don't have an account yet, create it now.


3. Configure the basic network settings

Choose whether you want to enable automatic network optimization and auto backups (we recommend keeping both enabled).


4. Set up your UniFi devices

If you have unadopted UniFi devices connected to your network, you will be able to configure them during this step.


5. Create a WiFi network

Specify a name and password for your new wireless network.


6. Complete the setup

Review your configuration to make sure everything looks good before completing the setup.


Frequently Asked Questions

How do I install the Network application on my UniFi Dream Machine or UniFi Cloud Key?

There's no need for a separate setup since all UDM, UDM-Pro and UCK models come with the UniFi Network application pre-installed.

You will go through the process of configuring the UniFi OS Console on these devices during the initial device setup and configuration and then can launch the Network application and add your UniFi devices.


I'm getting a Java-related error during setup, what do I do?

The UniFi Network application requires Java, so you'll need to install Java 8 for your specific platform before re-running the installer.


The install is not finishing successfully, what could it be?

Make sure that all system requirements are met and that all ports used by UniFi are open. If that is all in order, check that the ethernet cables are in good working condition, changing them with others if need be.


How do I access the UniFi OS Console configuration page if I don't know my IP?

If you haven't set up your console yet, try accessing it by navigating to or one of the common addresses: localhost:8443 or

If this doesn't work, you will need to find out the address of your gateway by using commands like ipconfig/ifconfig or device discovery tools like Ubiquiti's WiFiman.


I'm getting a "Your connection is not private" security warning when accessing the UniFi OS Console in my browser, should I be concerned?

There's nothing to worry about as it's the intended behavior when connecting to your UniFi OS Console locally. Simply proceed to the next page by clicking Advanced > Proceed.


How do I upgrade after the initial setup?

When a new stable version becomes available, you will receive an upgrade prompt in your dashboard. Click it to upgrade to the latest version. Otherwise go to the UniFi OS Dashboard > System Settings > Updates and check for updates there.


What are the UniFi Network application system requirements?

For self-hosted software setups, we recommend the following minimum system requirements (make sure to read the Release Notes for more details about a particular version):

  • Operating system:
    • Linux: Ubuntu Desktop / Server 16.04; Debian 9 "Stretch"
    • 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) 8
  • Web Browser: Google Chrome
  • MongoDB: version 3.2 or later. Mongo is offered bundled: default is 2.4.14 (for macOS and Windows only).


Does the UniFi Network application have to run at all times?

Since UniFi devices retain their settings, internet connectivity will work even if the UniFi OS Console is offline.

However, the features running directly on the UniFi OS Console will be lost. This includes statistics, reporting, manually applied user groups and the guest hotspot. If you did not set up a WPA security protocol under the guest hotspot's Advanced > Security, then if the Network application is down, users will be able to connect to that WiFi network without being prompted for a password.


How do I reset my UniFi Network password?

Generally you will use your UI account to log into the UniFI OS Console and launch the application from there. You can reset your UI account password by clicking "Forgot Password?" link and sending yourself a Password Reset email. If not using your UI account, and accessing locally, then you may use the 'Forgot Password' option that appears but only if you have configured your SMTP credentials first.

Was this article helpful?
940 out of 2261 found this helpful