Differences

This shows you the differences between two versions of the page.

--- install_unifi_on_ubuntu [2018/06/29 18:50] – created juckins
+++ install_unifi_on_ubuntu [2018/07/15 09:40] – juckins
@@ Line 1: / Line 1: @@
-==== Install Unifi on Ubuntu ====
+==== Install Unifi controller on Ubuntu ====
+These instructions were validated for unifi controller v5.7.23 being installed on Ubuntu 18.04 LTS.
+  * Start with clean install of Ubuntu 18.04 on Oracle VirtualBox v5.2.12.
+  * Install java 8 using [[https://websiteforstudents.com/how-to-install-oracle-java-jdk8-on-ubuntu-16-04-17-10-18-04-desktops/|websiteforstudents.com]] or [[https://tecadmin.net/install-oracle-java-8-ubuntu-via-ppa/|tecadmin.net]].
+  * If desired, install the [[https://firewalld.org/|firewall GUI administration tool]] from Software Center (apt install gnome-software)
+  * Review the [[https://help.ubnt.com/hc/en-us/articles/218506997-UniFi-Ports-Used|Unifi ports to open]]
+    * As of 14 July 2018, add TCP ports 8080, 8443 and UDP 3478 to public/permanent
+    * Note: Enabling Cloud Access and accessing the controller via [[https://unifi.ubnt.com]] instead does not require opening 8443, and is safer since no direct Internet access is permitted to your controller's management.
+<code>
+$ sudo -s
+$ cd /root
+$ mkdir downloads
+</code>
+Download the latest controller software from [[https://www.ubnt.com/download/unifi/|ubnt.com]].  It will be named something like "unifi_sysvinit_all.deb":
+<code>
+apt-get install ./unifi_sysvinit_all.deb
+</code>
+Fix /usr/bin/mongod noted in [[https://community.ubnt.com/t5/UniFi-Wireless/Unifi-controller-on-Ubuntu-18-04/td-p/2331657|community.ubnt.com]]:
+<code>
+$ cd /usr/bin
+$ sudo -s
+$ mv mongod mongod.bin
+</code>
+Replace mongod with the following:
+<code>
+#!/bin/bash
+cleaned_args=$(echo $* | sed -e 's/--nohttpinterface//')
+exec /usr/bin/mongod.bin ${cleaned_args}
+</code>
+Fix permissions:
+<code>
+$ chmod +x mongod
+</code>
+Restart services:
+<code>
+$ systemctl restart unifi
+$ systemctl status unifi
+</code>
+If desired, cat /var/log/unifi/server.log and mongod.log to ensure no errors are reported.
+Now you may use the VM or another machine to access the webpage on the virtual machine's IP (https://VM_IP_ADDRESS:8443/login)
+If the AP can't be found, do the following:
+ssh to AP IP address and login as ubnt, using the default password ubnt.  You may need to factory reset the controller if the password has been changed.
+Tell the AP where the controller software is running (IP below is VirtualMachine noted above):
+<code>
+set-inform http://192.168.1.182:8080/inform
+</code>
+Then login to the controller and adopt the AP.
+__Other notes__:
+  * [[https://calvin.me/install-unifi-controller-ubuntu/]]
+  * To get to the AP properties which list the radio channels and power output, click on "Statistics" in the controller's left sidebar and then click the AP's MAC address.