Skip to main content
Home Network

All Unifi SSH Commands that You Want to Know

By December 28, 2022June 27th, 2023No Comments

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.

infoinfoDisplays device information
set-defaultset-defaultFactory reset device
set-informset-inform URL of the controller for adoption. 
upgradeupgrade https://<firmware-url>.binUpgrade firmware
fwupdatefwupdate --url https://<firmware-url>.binUpdate firmware
rebootrebootReboot the device
poweroffpoweroffShutdown device
uptimeuptimeShows device uptime

Network related SSH Commands

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

ifconfigifconfigShow network interface information
ip address addip address add dev br0Set static IP Address
ip routeip routeDisplay current gateway
ip router addip route add default via default gateway
echo "nameserver" > /etc/resolv.confSet DNS Server
pingping network connection to device
arparp -aShow arp table
ip neighip neighShow 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:

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 rebootReboot device
ubnt-systool poweroffubnt-systool poweroffShutdown device
ubnt-systool reset2defaultsubnt-systool reset2defaultsFactory 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:

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.