Skip to main content

How to Access the Terminal on Cloud Key/UDM

Rakesh M avatar
Written by Rakesh M
Updated over 3 weeks ago

UniFi Cloud Gateways (Cloud Key, UDM, UDM Pro) no longer provide direct terminal access through the web interface, but you can reach the command line using SSH through an access point's debug terminal. This workaround requires at least one UniFi access point on the same network and takes less than 5 minutes to set up.

This guide walks you through enabling debug tools, configuring SSH on your Cloud Gateway, and accessing the terminal via an AP's debug console.

What you'll accomplish:

  • Enable debug tools in UniFi Network application

  • Configure SSH access on Cloud Key/UDM with password

  • Access terminal via AP debug console

  • Gain command-line access for advanced configuration

What you'll need:

  • Cloud Key, UDM, or UDM Pro

  • At least one UniFi Access Point on the same network

  • Admin access to UniFi Network application

Set Up

Enable Debug Tools

Log into the UniFi network application and, under Settings -> Advanced enable the Debug Tools option.

Enable SSH on Cloud Gateway and set a password.

Now go to OS Settings, navigate to the Console Settings tab, and enable the SSH option. Set up a password as well.

From the About screen, get the local IP as well.

Now go back to Network app and under Devices, pick any AP and open it's Debug terminal.

Once the terminal is open, just SSH into the Cloud Gateway :)

ssh root@<Cloud  Gatewau IP>

Terminal Access Established

Once you've enabled SSH and connected through an AP's debug terminal, you have full command-line access to your Cloud Gateway for advanced configuration, troubleshooting, or script execution.

What to do next:

  • Execute required commands for your configuration needs

  • Close SSH session when finished (exit command)

  • Disable SSH if not needed for security

Security note: Disable SSH when not actively using it to reduce security exposure. Enable it only when needed for maintenance or configuration tasks.

Still having trouble accessing the terminal? Contact Spotipo support via live chat or email us at [email protected].

Did this answer your question?