All Unifi SSH Commands that You Want to Know

Even though Unifi devices come with a great controller, sometimes you need to access your Unifi device through SSH. For example, to set up the initial connection, with the set-inform command. But what other SSH Commands are available for our Unifi devices?

Unifi SSH commands are not really documented, so most commands listed in this article come from different sources and own experience. If you have any other useful SSH commands, please add them in the commands below.

Unifi SSH Commands

We are going to start with the most commonly used Unifi SSH Commands, later on, I will organize them by device or function.

CommandExampleFunction
infoinfoDisplays device information
set-defaultset-default Factory reset device
set-informset-inform http://192.168.1.1:8080/informSet URL of the controller for adoption. More info
upgradeupgrade https://<firmware-url>.binUpgrade firmware – More info
fwupdatefwupdate --url https://<firmware-url>.bin Update firmware
rebootrebootReboot the device
poweroffpoweroffShutdown device
uptimeuptimeShows device uptime
Unifi SSH Commands

Network related SSH Commands

The following Unifi SSh Commands can really help you with finding network-related issues with your Unifi Device.

CommandExampleFunction
ifconfigifconfig Show network interface information
ip address addip address add 192.168.1.143/24 dev br0Set static IP Address
ip routeip routeDisplay current gateway
ip router addip route add default via 192.168.1.1Set default gateway
echo "nameserver 192.168.1.1" > /etc/resolv.confSet DNS Server
pingping 1.1.1.1Check network connection to device
arpapr -aShow arp table
ip neigh ip neigh Show IPv6 neighbors

Unifi OS SSH Commands

When you connect to your UDM Pro (or another controller that is running Unifi OS), then you will have a couple of other options:

CommandExampleFunction
ubnt-systool cputempubnt-systool cputempShow CPU Temp
ubnt-systool cpuloadubnt-systool cpuloadShow CPU load
ubnt-systool portstatusubnt-systool portstatusShow port status
ubnt-systool hostnameubnt-systool hostname <newname>Set new hostname
ubnt-systool rebootubnt-systool reboot Reboot device
ubnt-systool reset2defaultsubnt-systool reset2defaults Factory reset device
ubnt-device-info summaryubnt-device-info summaryShow system information
ubnt-tools ubnt-discoverubnt-tools ubnt-discoverShow Unifi devices in the network
cat /mnt/data/udapi-config/dnsmasq.leasecat /mnt/data/udapi-config/dnsmasq.leaseShow DHCP Leases
cat /mnt/data/udapi-config/unificat /mnt/data/udapi-config/unifiShow configuration
/etc/init.d/S95unifios restart/etc/init.d/S95unifios restartRestart Unifi OS Web interface

Unifi Log files

There are a lot of log files that you can access to help you debug any Unifi related problem:

CommandFunction
cat /var/log/messagesOutput the error log
tail -f /var/log/messagesMonitor log file
cat /mnt/data/unifi-os/unifi-core/config/settings.yamlServer settings
cat /mnt/data/unifi-os/unifi-core/logs/discovery.logDiscovery log
cat /mnt/data/unifi-os/unifi-core/logs/system.logSystem log
cat /mnt/data/unifi-os/unifi/logs/server.logServer log
cat /mnt/data/unifi-os/unifi-core/logs/errors.logHttp errors

Wrapping Up

Unifi devices are running on a form of Linux, so most Linux commands will work on the devices. Pressing Tab twice will give you a list of all available SSH commands.

Keep in mind that the Unifi Controller will override most settings when you make changes directly in the device.

5 thoughts on “All Unifi SSH Commands that You Want to Know”

  1. Love it! Thank you. BTW, I’ve been unable to find the most important one to me. With the older APs no longer supported, I set them up as standalone which has a mind of its own and never takes my SSID, renaming or security settings. Do you know the CLI command to change the SSID via CLI? Love your site. Thanks, again.

    • I don’t know if there is an SSH command for it, but you can try to modify the system.cfg file:

      cat /tmp/system.cfg | grep OLDSSID

      Don’t know if it will work, you will have to try it out

Leave a Comment

0 Shares
Tweet
Pin
Share
Share