|⇐ Back||Page||Next ⇒|
The next step is to install the UniFi Controller software.
- Add the UniFi repository to the sources list, using the following commands:
echo 'deb http://www.ubnt.com/downloads/unifi/debian unifi4 ubiquiti' | sudo tee -a /etc/apt/sources.list.d/100-ubnt.list > /dev/null sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50 sudo apt-get update
- Install UniFi, using the following package install command:
sudo apt-get -y install unifi
The installation takes a couple of minutes to complete, but is fully automated and includes components such as MongoDB.
- Stop and disable the default MongoDB database instance, using the following commands:
sudo systemctl stop mongodb sudo systemctl disable mongodb
Without making this configuration change, you will have two separate instances of MongoDB running; an unused default database instance, and the UniFi database instance. This is obviously not desirable on a device with limited resources, such as the Raspberry Pi.
- Upgrade the Snappy Java Library, using the following commands:
cd /usr/lib/unifi/lib sudo rm snappy-java-1.0.5.jar sudo wget https://repo1.maven.org/maven2/org/xerial/snappy/snappy-java/1.1.2/snappy-java-1.1.2.jar sudo ln -s snappy-java-1.1.2.jar snappy-java-1.0.5.jar
The version included with the UniFi package is significantly out-of-date, and has many known bugs and compatibility issues.
- On the Raspberry Pi 1 and Raspberry Pi Zero (W), which are both older ARMv6-based devices, UniFi Cloud Library support must be removed using the following command:
sudo rm /usr/lib/unifi/lib/native/Linux/armhf/libubnt_webrtc_jni.so
UniFi Cloud access is not supported on ARMv6-based devices, and the presence of this library will stop the UniFi software from starting on these devices.
- Once completed, reboot your Raspberry Pi using the following command:
When the reboot is complete, proceed with the Setup Wizard.
- Use a web browser to view HTTPS port 8443 on your Raspberry Pi:
<raspberrypi>in the above example with the IP address of your Raspberry Pi. The UniFi Setup Wizard page will be displayed.
- Select your country and timezone, then click Next. The Discover page will be displayed.
- If you have any unmanaged devices on the network, you may select them here, then click Next. The Wireless page will be displayed.
- Enter your new wireless Secure SSID and Security Key, then click Next, or click Skip to do this later. The Password page will be displayed.
- Enter an Admin Name, Password and Confirm Password for UniFi Controller access, then click Next. The Finish page will be displayed.
- Review the settings shown, then click Finish. The Login page will be displayed.
- Enter your Username and Password, then click Login. The Dashboard will be displayed. The Ubiquiti UniFi Controller software is now installed and running on your Raspberry Pi!
|⇐ Back||Page||Next ⇒|