Managing the UDM Pro’s OS via Command Line

Doing it this way allows you to restart the UDM Pro’s “brain” without having it reset all your network connections. It is not uncommon for the UDM to lose its interface while still passing traffic properly. It is still very much a beta (alpha?) product.

Start by logging in via ssh:

ssh root@unifi.tek

Don’t forget that the login is always root. This assumes you’ve already set up a password.

The command for managing the UDM Pro’s Operating System is: unifi-os

So, to restart the OS of the UDM Pro, the command would be

unifi-os restart

You can also get a shell within the UDM’s OS via

unifi-os shell

According to its (brief) help message, the following commands are available:

Usage: /usr/sbin/unifi-os [stop start restart shell 'update url']

3 thoughts on “Managing the UDM Pro’s OS via Command Line”

  1. You are not allowed to install packages or modify things like you might be used to on other Linux-based devices. : [ [[ alias bg break cd chdir command continue echo eval exec exit export false fg getopts hash help history jobs kill let local printf pwd read readonly return set shift source test times trap true type ulimit umask unalias unset wait Standard Linux commands like ifconfig, tcpdump, netstat, whoami and cat are also available. There are also some commands and files that are unique to the UDM and not well documented by Ubiquiti.

    • No, but there are some things you might want to do. There are JSON files you can create/edit to customize your installation, or you might just want to see what’s going on under the hood and look at some logs. The UDM UI is nice, but is severely limited in the amount of real information you can get out of it. I don’t tend to change anything, but I do go in there when I have to look at logs or see whatever else is going wrong, which is an all too common occurrence.

  2. I called mine : NB: Change my entries to the right values for your domain and DNS server! Save that file then make it executable: Test it: Check for your new config in the directory. Check the content with: Now restart the UDM and repeat the checks that the file is there and has the correct content.


Leave a Comment