UniFi Switch: How to access the CLI & Config via SSH | Archive

This post was originally published on jcutrer.com (WordPress) and has been migrated to the archive.

In this article, I will show you how to access a UniFi switch’s CLI interface and configuration. As you know, UniFi Switches are controlled and configured through the UniFi Controller. When you SSH to the switch you only get a linux shell prompt rather than a command line interface.

Here is how to connect to the UniFi switch CLI

- SSH to the switch & login.

The credentials can be found in your UniFi controller’s settings. - At the # prompt, telnet to 127.0.0.1 - At the (UBNT) > prompt type “enable” - Type “show run” to output the running configuration of the switch

BusyBox v1.19.4 (2017-07-12 21:42:26 PDT) built-in shell (ash)
Enter 'help' for a list of built-in commands.

US.v3.8.6# telnet 127.0.0.1

Entering character mode
Escape character is '^]'.

Warning!
The changes may break controller settings and only be effective until reboot.

(UBNT) >enable

(UBNT) #show run

!Current Configuration:
!
!System Description "USW-48P-500, 3.8.6.6650, Linux 3.6.5"
!System Software Version "3.8.6.6650"
!System Up Time          "61 days 16 hrs 24 mins 2 secs"
!Additional Packages     QOS,IPv6 Management
!
....

Once you have reached the (UBNT) # prompt you are effectively configuring an EdgeSwitch, (https://dl.ubnt.com/guides/edgemax/EdgeSwitch_CLI_Command_Reference_UG.pdf).

If you want to backup the configuration file you can use one of the following commands.

# 
# Backup unifi switch config over FTP
(UBNT) # copy system:running-config ftp://user@192.168.1.20/unfi-switch.cfg

#
# Backup unifi switch config over TFTP
(UBNT) # copy system:running-config tftp://192.168.1.20/unfi-switch.cfg

#

To make changes to the switch configuration use the configure command to enter config mode. Here is an example of how to change the description for interface 0/1

(UBNT) #config

(UBNT) (Config)#interface  0/1

(UBNT) (Interface 0/1)#description "Port 1 Testing"

(UBNT) (Interface 0/1)#exit

(UBNT) (Config)#exit

(UBNT) #exit

Note: Configuration changes you make to the switch via the CLI will be overwritten by the UniFi controller when the switch is restarted.