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:07] – 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)