UniFi has a very useful feature baked in which allows you to access the command line interface of your UniFi devices.

Contents

Why would you need this?

How to access the debug console

Why would you need this?

Let's imagine you have a remote UniFi instance hosted in HostiFi. The client plugs in a new access point and wants to get it adopted within the controller, but for some reason it isn't automatically.

The usual next step is to SSH into the device and then set the set-inform command to adopt it to HostiFi. However, if we are remote then we have no access to the device. This is where the debug console comes in.

Debug console allows us to access the command line interface of a device and then from there, we can initiate an ssh connection to the device we cannot add to HostiFi.

This tool can be used in many ways, such as updating the firmware on a device that cannot be adopted as it is too old and much more.

How to access the debug console

Ubiquiti has only recently added support for the debug console on the new user interface, for that reason we will cover both the new and old versions of the UniFi user interface.

New user interface

First, log into your UniFi instance and select 'Devices'

Next, select the device you need to access the debug console from. Note, the UXG Pro, USG and USG Pro do not support this feature.

Next, in the device pop out panel - click on Settings

Next, click on the 'Manage' drop down, then 'Debug'

Then, the debug window will open and you can access the SSH console for that device.

Old user interface

First, log into your UniFi instance and select 'Devices'

Next, select the device you need to access the debug console from. Note, the UXG Pro, USG and USG Pro do not support this feature.

Next, in the device pop out panel - click on 'Tools'

Then, click on 'Open terminal'

Then, the debug window will open and you can access the SSH console for that device.

HostiFi

HostiFi provides hosting for Ubiquiti hardware and software, with servers for UniFi and UISP as well as professional network services 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?