Skip to content

Unifi controller

Setup UniFi Controller on Raspberry Pi

The following notes related to installing UniFi Controller to a Raspberry Pi. This is alternatively to buying a Ubiquiti Cloud Key.

[1] Ensure that your Raspberry Pi has a static IP address

  • in your router settings, assign a static IP address to your Raspberry Pi.

[2] Install Java

  • Run sudo apt-get install openjdk-8-jre-headless -y to install Java on the Raspberry Pi
  • The following command may need to be run to fix broken dependencies sudo apt-get install -f

[3] Install the UniFi Cloud Key software

  • Go to this website to download the controller software.
  • Copy the URL of the download.
  • Navigate to /usr/local/src/ in your Raspberry Pi (in terminal).
  • Run sudo wget <url> to download the installation package.
  • Run sudo dpkg -i unifi_sysvinit_all.deb to install the package. Ensure that the name matches the file name of the downloaded package.

[4] UniFi service status/start/stop/restart

  • Run sudo service unifi status to check the status
  • Run sudo service unifi start to start the unifi service
  • Run sudo service unifi restart to restart the unifi service
  • Run sudo service unifi stop to check the stop

[5] Log into UniFi Controller

  • In the browser, navigate to https://<raspberry_pi_IP_address>:8443
  • Go through wizard to setup the cloud key. Choose the local

References