Christopher Juckins

SysAdmin Tips, Tricks and other Software Tools

User Tools

Site Tools


install_unifi_on_ubuntu

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
install_unifi_on_ubuntu [2018/07/15 08:32] juckinsinstall_unifi_on_ubuntu [2018/07/15 09:49] juckins
Line 4: Line 4:
   * Start with clean install of Ubuntu 18.04 on Oracle VirtualBox v5.2.12.   * 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]].   * 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 the Ubuntu Software icon that shows up in the left sidebar after a clean install using the default desktop +  * 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]] +  * 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 +    * 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.+    * 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> <code>
 $ sudo -s $ sudo -s
 +$ cd /root
 +$ mkdir downloads
 </code> </code>
 +Download and then install 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 as 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.
install_unifi_on_ubuntu.txt · Last modified: 2023/01/09 21:17 by juckins