Ubiquiti

The Unifi Controller from Ubiquiti Networks is a software management solution for their range of WiFi access point devices.

Reboot

 * 1) With a paper clip, depress the Reset button until you feel it click. Hold for 1 second, then let go.

Reset
Normal Method


 * 1) With a paper clip, depress the Reset button until you feel it click. Hold for 10 seconds, then let go.

Hail Mary Method


 * 1) Unplug the power cable.
 * 2) With a paper clip, depress the Reset button until you feel it click. Hold firm.
 * 3) Plug in power, while continuing to hold paper clip firm.
 * 4) Wait until the LED begins flashing in a repeating pattern: Off Blue White.
 * 5) Release paper clip reset.
 * 6) Unplug the power cable. Wait 5 seconds; say Hail Mary, and plug power cable back in.

EdgeMax Dual WAN Failover Load Balancing
https://help.ubnt.com/hc/en-us/articles/205145990-EdgeMAX-Dual-WAN-load-balance-feature

UniFi VoIP - How to Manually Upgrade UVP App/Platform
SipService.apk

UnifiPhone.apk

https://community.ubnt.com/t5/UniFi-VoIP/UniFi-VoIP-How-to-Manually-Upgrade-UVP-App-Platform/ta-p/1293920

HOWTO: Improve Throughput On PPPoE
configure set system offload ipv4 pppoe enable commit save exit

Thanks - https://blog.linitx.com/howto-significantly-improve-slow-throughput-edgerouter-lite-pppoe/

SSH Keys Access
Copy your SSH public key to the device...

scp /home/user/.ssh/id_rsa.pub ubnt@192.168.0.1:~/id_rsa.pub

Log in to the device...

ssh ubnt@192.168.0.1

Switch to configure mode...

configure

Load SSH key to the user...

loadkey ubnt ~/id_rsa.pub

Commit...

commit

Save ...

save

Exit...

exit

Logout and test...

exit ssh ubnt@192.168.0.1

Thanks - https://community.ubnt.com/t5/EdgeMAX/ssh-authorized-keys/td-p/458361

Thanks - http://www.bciuca.com/2014/02/08/edgemax-ssh-pubkey/

Network Monitoring Data Collection
NetFlow

configure set system flow-accounting interface set system flow-accounting netflow engine-id <0-255> set system flow-accounting netflow server  port 2055 set system flow-accounting netflow version <1|5|9> commit
 * 1) Optional parameter if flows should be collected for egress traffic.
 * 2) set system flow-accounting netflow enable-egress

https://community.ubnt.com/t5/EdgeMAX/Help-setting-up-NetFlow/td-p/464367

https://community.ubnt.com/t5/EdgeMAX/Netflow/m-p/365221#M3097

https://www.reddit.com/r/Ubiquiti/comments/3kobad/netflow_on_edgerouter_x_on_17/

https://forums.manageengine.com/topic/ubiquiti-edgemax-analyzer-config-issue

nTop

http://www.ntop.org/nprobe/running-nprobe-and-ntopng-on-ubiquity-edgerouter-lite/

Forum
https://help.ubnt.com/hc/en-us/categories/200321064-EdgeMAX

Bootloader Update
curl -O https://dl.ubnt.com/firmwares/edgemax/v1.8.0/update-boot.sh sudo bash update-boot.sh reboot

https://community.ubnt.com/t5/EdgeMAX-Updates-Blog/EdgeMAX-EdgeRouter-X-X-SFP-bootloader-update/ba-p/1472216

uPnP
Config Tree > service > upnp > listen-on > interface

SNMP
http://leerspace.com/2014/11/08/snmp-and-mrtg-ubiquiti-edgerouter-lite-ubuntu-server/

https://gist.github.com/nbrownus/dfd8ab05728bbf8ff5993ac0d34eaeb6

Firewall Regions Explanation
WAN_IN is from the internet, through the router, and onward to your LAN. In very general terms, you want to drop 90% of this mess - it's script kiddies, port scans, nigerian princes, and anyone else you don't want able to head through your router. Obviously, you're gonna want to allow ports 80, 443, 25, and others if you're running those types of services. If you haven't got any idea what I'm talking about with those three ports, better to not open them.

WAN_LOCAL is from the internet to your router, with no intention of going farther. Best to just drop everything on this interface -- unless, for example it's a router at a remote site, and you've got a static at your main site, so you allow traffic from 10.10.x.y/28 (note, I'm using private address space as an example, real world would depend on your ISP).

LAN_IN is everything inbound to the router from your LAN (e.g. 192.168.1.0/24) that's destined for somewhere else (WAN, other LAN such as 192.168.2.0/24). In a SMB, or SOHO setup, this is probably explicitly permissive. In an enterprise setting, this may or may not be permissive (e.g. blocking all outgoing traffic except for SFTP on a non-standard port).

LAN_LOCAL is everything inbound to the router from your LAN destined for the router. Again, unless you're doing enterprise routing, this is probably fairly open - although good SMB setups with guest networks may block the guest network range.

Command Auto Completion
You can press the ? key to find the top-level commands, then type that command and ? again to find the options for that top-level command.

? show ? show version show interfaces show interfaces ? show interfaces ethernet

You can also use the keyboard Tab button to complete the options.

Show Configuration
There are 2 ways to show the current configuration - in a tree or in commands:-

show configuration all show configuration commands

If you use the 'commands' option, you can then grep or 'match' the output to limit results.

show configuration commands | match system

Edit Configuration
You have to enter 'edit' mode first, and it will show you after every command that you are in this 'edit' mode with a separate line just above the prompt showing [edit]...

configure

When you have finished your command changes, you can show your changes, to check...

compare

To make the changes active, you have to save them...

commit

Then, come out of configure mode...

exit

EdgeRouter VDSL
Yes it does support BT FTTC Infinity. Use PPoE and connect to white BT modem with Cat 5e cable. Set MTU at 1492.

https://community.ubnt.com/t5/UniFi-Routing-Switching/does-edgerouter-support-vdsl/td-p/1112045

https://community.plus.net/t5/Fibre-Broadband/Config-for-Ubiquiti-ER-X-EdgeRouter-X-on-Plusnet-FTTC/m-p/1293820

https://community.ubnt.com/t5/EdgeMAX/BT-infinity-fibre-optic-setup/m-p/1183648/highlight/true#M57491

http://wiki.indie-it.com/wiki/DSL_Devices#British_Telecom

Purchase


 * http://www.broadbandbuyer.co.uk/products/21797-ubiquiti-er-x-uk/
 * https://linitx.com/product/ubiquiti-edgemax-edgerouter-x-uk-psu/14588

https://mangolassi.it/search?term=er-x&in=titlesposts

Default Username & Password
Username: ubnt Password: ubnt

Maximum Password Length
Eight characters

IPSec VPN Passthrough
http://community.ubnt.com/t5/EdgeMAX/Newbie-Simple-1-LAN-1-WAN-SOHO-Setup/td-p/1377745

HOWTO: INSTALL: DEPENDANT SOFTWARE:
'''** THIS IS NOW NO LONGER REQUIRED. PLEASE SEE 16.04 INSTRUCTIONS BELOW **'''

ORACLE JAVA 8:
Add the repository:

sudo nano /etc/apt/sources.list deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main
 * 1) Java 8

Save (CTRL+o) and exit (CTRL+x).

Add the keyserver and install the software:

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com EEA14886 sudo apt-get update sudo apt-get install jsvc oracle-java8-installer oracle-java8-set-default

Check the installed version:

java -version

MongoDB:
Open the sources.list and add the line shown in bold at the end of the file:

sudo nano /etc/apt/sources.list deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen

Save (CTRL+o) and exit (CTRL+x).

Add the keyserver and install the software:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10 sudo apt-get update sudo apt-get install mongodb

HOWTO: INSTALL: UniFi
UniFi can either be installed from a .deb file or via a PPA repository:

Ubuntu Server 16.04 From .deb File:

 * 1) Visit Ubiquiti's download page
 * 2) In the SOFTWARE section, click on "UniFi v4.x.x Controller for Debian/Ubuntu Linux"
 * 3) Locate the file called "unifi_sysvinit_all.deb" and download it

sudo dpkg -i unifi_sysvinit_all.deb sudo apt-get -f install

Ubuntu Server 14.04 From .deb File:

 * Visit Ubiquiti's download page
 * In the SOFTWARE section, click on "UniFi v4.x.x Controller for Debian/Ubuntu Linux"
 * Locate the file called "unifi_sysvinit_all.deb" and download it

sudo dpkg -i --force-depends unifi_sysvinit_all.deb

Ubuntu Server 14.04 From Repository:
The following is an installation on Ubuntu Server 14.04.

Add the repository and keyservers by editing the following file adding the lines shown in bold at the end of the file:

sudo nano /etc/apt/sources.list

deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen
 * 1) Ubiquiti Unifi
 * 1) Mongodb

Add the following key servers, the first for Unifi itself the second for MongoDB: sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10 sudo apt-get update Finally install the software: sudo apt-get install unifi stable, or sudo apt-get install unifi-rapid better than standard not as bleeding edged as beta sudo apt-get install unifi-beta

Official
http://community.ubnt.com/t5/UniFi-Wireless/Raspberry-Pi-and-Unifi/m-p/1167782#M91180

http://community.ubnt.com/t5/UniFi-Wireless/Finished-Raspberry-PI2-Image/m-p/1187658#M94346

http://community.ubnt.com/t5/UniFi-Controller-Installation/UniFi-Installing-the-Controller-software-on-Raspberry-Pi/ta-p/1127992

https://community.ubnt.com/t5/UniFi-Wireless/Unifi-4-6-3-on-raspberry-pi-2/m-p/1249829

https://community.ubnt.com/t5/UniFi-Wireless/New-upgraded-Raspberry-Pi-2-as-a-unifi-controller/td-p/1164776

Unofficial
Logan Marchione.

Kowen Houston - Instructions here.

Kowen Houston - Download here.

Erik Van Paassen

Lowe Family

Amazon Web Services
https://www.youtube.com/watch?v=NSMM5dT1vSk

https://www.youtube.com/watch?v=y5tkToD_nds

Define The Java Version:
Edit the following file, adding the path to Java 8 installation: sudo nano /etc/init.d/unifi JAVA_HOME= # Edit this line to match that shown below JAVA_HOME=/usr/lib/jvm/java-8-oracle

Open The Required Firewall Ports:
Open ports on the server's firewall (in this example UFW):

For internal connection: sudo ufw allow from 192.168.0.0/24 to any port 8080 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 8081 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 8443 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 8843 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 8880 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 27117 proto tcp sudo ufw allow from 192.168.0.0/24 to any port 3478 proto udp

Details of the ports required by Unifi can be found here.

Port 3478 UDP relates to STUN server usage so if you are not using VOIP hardware this port is not needed.

If your server already uses any of the ports listed above how to change those used by Unifi can be found here.

The file to alter to use different ports can be found in the following location:

/usr/lib/unifi/data/system.properties

Accessing The Web Interface:
https://your.server.ip:8443/manage

All being well you should see similar to the picture below:



Backup File
https://help.ubnt.com/hc/en-us/articles/205231940

config.properties File

 * https://help.ubnt.com/hc/en-us/articles/205146040
 * https://help.ubnt.com/hc/en-us/articles/205202580

Location, creation & edition:

cd var/lib/unifi/sites/{site_name} '''# This can be found from the address bar in the browser, if it is the first controller you have created it should be called 'default' sudo touch config.properties sudo nano -w config.properties

Log Files
https://help.ubnt.com/hc/en-us/articles/204959834

Zero Handoff
https://help.ubnt.com/hc/en-us/articles/205144590

Start, Stop or Restart
sudo service unifi start|stop|restart

View Log File
cat /var/log/unifi/server.log

EdgeMax - Time Based MAC Address Blocking
rule 10 { action drop description "Block Gaming PC" source { mac-address 11:11:11:11:11:11 }    time { starttime 22:00:00 stoptime 07:59:59 weekdays Mon,Tue,Wed,Thu }    time { starttime 00:00:00 stoptime 07:59:59 weekdays Fri,Sat } }

Quoted here by me - https://community.ubnt.com/t5/EdgeMAX/Set-up-time-limits-for-kids-internet-access/m-p/1826628#M149231

Thanks to Ubiquiti Community Forum

Error: MongoDB Journal Files Eating Disc Space.
LATEST DEFINITIVE FIX


 * 1) stop system wide mongodb from starting
 * 2) edit system.properties file for smallfiles parameter
 * 3) start unifi

sudo nano /etc/init/mongodb.conf ENABLE_MONGODB="no" sudo nano /usr/lib/unifi/data/system.properties unifi.db.extraargs=--smallfiles sudo update-rc.d -f mongodb remove sudo service unifi start

Thanks - https://community.ubnt.com/t5/UniFi-Wireless/UNIFI-Eating-all-disk-space-Mongodb/td-p/395410

Also - https://help.ubnt.com/hc/en-us/articles/204911424-UniFi-How-to-remove-prune-older-data-and-adjust-mongo-database-size

$ ll /var/lib/mongodb/journal/ total 3.1G drwxr-xr-x 2 mongodb nogroup 4.0K 2015-08-03 15:54. drwxr-xr-x 3 mongodb mongodb 4.0K 2015-08-03 15:22 .. -rw--- 1 mongodb nogroup 1.0G 2015-08-03 15:54 prealloc.0 -rw--- 1 mongodb nogroup 1.0G 2015-08-03 15:43 prealloc.1 -rw--- 1 mongodb nogroup 1.0G 2015-08-03 15:43 prealloc.2

$ rm -rfv /var/lib/mongodb/journal/* removed ‘/var/lib/mongodb/journal/prealloc.0’ removed ‘/var/lib/mongodb/journal/prealloc.1’ removed ‘/var/lib/mongodb/journal/prealloc.2’

$ df Filesystem    Type  Size  Used Avail Use% Mounted on /dev/sda1      ext4   10G  3.5G  6.0G  37% /

$ nano /usr/lib/unifi/data/system.properties unifi.db.nojournal=true      # disable mongodb journaling

Error: Keystore Missing.
If the the following is listed in the error log file:

/usr/lib/unifi/data/keystore (No such file or directory)

FIX

sudo service unifi stop sudo keytool -genkey -keyalg RSA -alias selfsigned -keystore /usr/lib/unifi/data/keystore -storepass aircontrolenterprise -validity 365 -keysize 2048 -destalias unifi

Answer the following questions by pressing enter up until the line starting "Is CN=" when you will need to answer "Y" then press enter:

What is your first and last name? [Unknown]: What is the name of your organizational unit? [Unknown]: What is the name of your organization? [Unknown]: What is the name of your City or Locality? [Unknown]: What is the name of your State or Province? [Unknown]: What is the two-letter country code for this unit? [Unknown]: Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct? [no]:

Finally start Unifi:

sudo service unifi start

Thanks to Calvin Bui.

HOME

 * 1) Modem Router Firewall
 * 2) POE Switch
 * 3) Wi-Fi Access Point

Guest Network
https://www.youtube.com/watch?v=I8D6ju2AvpI

https://help.ubnt.com/hc/en-us/articles/205222660

Ubiquiti Videos
Various

Review
http://arstechnica.com/gadgets/2015/10/review-ubiquiti-unifi-made-me-realize-how-terrible-consumer-wi-fi-gear-is/

CLI
https://help.ubnt.com/hc/en-us/articles/204976584-EdgeMAX-Connect-to-CLI-With-Telnet

http://community.ubnt.com/t5/tkb/v2/page/blog-id/CLI_Basics%40tkb/page/1

EdgeRouter Pro
http://community.ubnt.com/t5/EdgeMAX/Newbie-Simple-1-LAN-1-WAN-SOHO-Setup/m-p/1377745

http://community.ubnt.com/t5/EdgeMAX/Basic-SOHO-Home-Config/m-p/398057

https://help.ubnt.com/hc/en-us/articles/205197660-EdgeMAX-SOHO-Example

http://sohovercomplicated.com/edgerouter-basic-soho-router-firewall-part-1-the-basics/

UniFi
https://community.ubnt.com/t5/UniFi-Updates-Blog/UniFi-3-2-7-is-released/ba-p/1085473

https://community.ubnt.com/t5/UniFi-Wireless/Unifi-4-2-Controller-Install-Guide-Linux-Ubuntu-Server-14-10/td-p/1158280

https://community.ubnt.com/t5/UniFi-Wireless/UNIFI-controller-for-linux/m-p/962877

https://community.ubnt.com/t5/UniFi-Wireless/UniFi-controller-on-Debian-v7-1-x64-not-working/td-p/523245

http://wiki.ubnt.com/UniFi_FAQ#Operation_and_Deployment

http://sunstatetechnology.com/docs/UniFiControllerInstallation.pdf

https://calvin.me/install-unifi-controller-ubuntu/

https://community.ubnt.com/t5/UniFi-Wireless/Unifi-Controller-Setup-for-Remote-Location-Cloud-NOC/td-p/312142

http://community.ubnt.com/t5/UniFi-Controller-Installation/UniFi-Install-the-controller-software-on-the-UniFi-Video-NVR/ta-p/814754

https://www.youtube.com/watch?v=NSMM5dT1vSk

http://www.msdist.co.uk/Unifi_questions_extract_from_Ubiquiti_Forum.pdf

https://www.youtube.com/watch?v=juE0qH-D6Gs&index=3&list=PLqmQzXAOhOQj8AT31sc1seFJG0v0sSQ0m

https://www.youtube.com/watch?v=uKxgyt1kArw&index=15&list=PLqmQzXAOhOQj8AT31sc1seFJG0v0sSQ0m

Error related:

https://community.ubnt.com/t5/UniFi-Wireless/UniFi-Apache-500-Error/td-p/948953

https://community.ubnt.com/t5/UniFi-Wireless/UniFi-on-Ubuntu-help-needed/td-p/238635

http://community.ubnt.com/t5/UniFi-Wireless/HTTP-Status-400/td-p/621497

http://community.ubnt.com/t5/UniFi-Wireless/Apache-Tomcat-HTTP-Status-400/m-p/654089/highlight/true

http://forum.thecus.com/viewtopic.php?f=36&t=8004