UniFi - UXG Command-line guide

Learn how to get the most out of your UXG with some SSH commands

Alex Lowe avatar
Written by Alex Lowe
Updated over a week ago

Pretty much all networking devices have a command-line interface that you can use. Typically, these have way more features than the GUI would ever have.

How to SSH into the UXG Pro

We have a dedicated guide on the support centre to show you how to log into the UXG Pro using SSH. You can find that here.

Commands

Check the CPU Temperature

To check the CPU temperature enter in the following:

ubnt-systool cputemp

It'll then display a readout:

34

This temperature is in celsius, but this is something that isn't obtainable from the UniFi GUI.

Device Uptime

To check the device uptime, enter in the following:

uptime

It'll then display a readout:

12:50:01 up 7 days, 33 min,  1 user,  load average: 1.01, 0.42, 0.34

It shows the current time, device uptime and how many users are on the network. As well as the load average stats.

Sensor Information

To check the device sensors, enter in the following:

sensors

It'll then display a readout:

adt7475-i2c-4-2e
Adapter: i2c-0-mux (chan_id 3)
in1: 891.00 mV (min = +0.00 V, max = +2.99 V)
+3.3V: 3.26 V (min = +2.96 V, max = +3.63 V)
fan1: 0 RPM (min = 0 RPM)
fan2: 1186 RPM (min = 0 RPM)
fan3: 1186 RPM (min = 0 RPM)
fan4: 1186 RPM (min = 0 RPM)
temp1: +34.8°C (low = -63.0°C, high = +191.0°C)
(crit = +100.0°C, hyst = +96.0°C)
Board Temp: +33.2°C (low = -63.0°C, high = +191.0°C)
(crit = +100.0°C, hyst = +96.0°C)
temp3: +29.2°C (low = -63.0°C, high = +191.0°C)
(crit = +100.0°C, hyst = +96.0°C)

It shows detailed information about the fan speed, voltages, temperatures from the system as well as the low and critical thresholds.

Ubiquiti Discovery

To run a local Ubiquiti discovery, enter in the following:

ubnt-tools ubnt-discover

The UXG Pro will then find any devices that are pending adoption or non-UniFi devices, such as the NanoStation this UXG has found:

Hardware Address  IP address            Name
18:E8:29:XX:XX:XX 172.18.38.170 NS-5AC 'NanoStation 5AC'
Total: 1 devices.

Manual Firmware Update

Sometimes a new firmware update for the UXG Pro can only be completed via the SSH interface, to do this enter in the following:

ubnt-systool fwupdate [URL]

In the [URL] section, enter in the URL supplied by Ubiquiti for the UXG Pro. The device will download the firmware and then reboot.

HostiFi

HostiFi provides hosting for both Ubiquiti and TP-Link software-defined-networking (SDN) applications, with servers for UniFi, UISP and Omada. We also offer professional networking consulting, with HostiFi Pro.

If you run into any issues, send an email to support@hostifi.com or contact us via live chat.

Did this answer your question?