Main ssh commands for Unifi Access Point

I will put here the ssh commands for Ubiquiti WiFi AP that I use.

Connect to AP via ssh

Ubiquiti Device Discovery

If you don't know how to get the IP Address of your APs, you can use the Ubiquiti Device Discovery tool to find it.

Ubiquiti Device Discovery

Connect through ssh

  • Once we have the IP Address, we can connect through ssh (default login/password : ubnt / ubnt) :
user@host:~$ ssh -l ubnt 192.168.1.20
Ubiquiti ssh prompt

ssh password for already registered devices

I will show here how to get or set the ssh password for a Network Management Controller registered device.

  • From the Network Management Controller, go to settings :
ubiquiti manager dashboard

From the Classic interface

  • From Site menu, check Enable advanced features and click on Apply Changes :
ubiquiti manager Site menu
  • Still from Site menu, you should now see the Device Authentication section. From there you will have the possibility to show or set the ssh password :
ubiquiti manager Site menu, Device Authentication

From the New interface

  • From Network Settings > Device Authentication menu, you will have the possibility to show or set the ssh password :
ubiquiti manager Network Settings, Device Authentication, ssh authentication

Set temporary Network Configuration

To be able to download the latest firmware, it can be useful to know how to set networks parameters.

  • Add ip address :
UBNT-BZ.v4.3.21# ip addr add 192.168.1.143/24 dev br0
  • Set default gateway :
UBNT-BZ.v4.3.21# ip route add default via 192.168.1.254
  • Set dns :
UBNT-BZ.v4.3.21# echo "nameserver 192.168.1.254" > /etc/resolv.conf

Firmware

Firmware Upgrade

If we want to upgrade firmware from ssh, first go to https://www.ui.com/download/ webpage. And get your firmware device URL.

Ubiquiti website url download
  • Now you can start the firmware upgrade :
UBNT-BZ.v4.3.20# upgrade https://dl.ui.com/unifi/firmware/BZ2/4.3.21.11325/BZ.ar7240.v4.3.21.11325.200922.1739.bin
Downloading firmware from 'https://dl.ui.com/unifi/firmware/BZ2/4.3.21.11325/BZ.ar7240.v4.3.21.11325.200922.1739.bin'.

Scheduling firmware upgrade...
Waiting for upgrade to start...

Others

  • To get main informations as model, version, MAC etc :
UBNT-BZ.v4.3.21# info
Ubiquiti ssh informations.
  • Reset device to factory defaults :
UBNT-BZ.v4.3.21# syswrapper.sh restore-default
  • Or :
UBNT-BZ.v4.3.21# set-default
  • Set Unifi Controller :
UBNT-BZ.v4.3.21# mca-cli
UniFi# set-inform http://your.unifi.controller:8080/inform
  • Set password :
UBNT-BZ.v4.3.21# passwd
Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Contact :