Skip to main content

Your Shell - A Beginner's Guide

The terminal is your gateway to the inner workings of your slot. It is essentially a remote computer running Linux, and when you SSH into it, you are connecting to that computer's terminal. For instructions on how to connect to your slot via SSH, follow this link.

A terminal is a powerful tool where you can execute written commands to perform many simple or even very complicated tasks. This guide will help you understand a few simple commands to get you started navigating and using the Linux terminal; it can also serve as a cheat sheet later down the track if you need to recall anything you may have forgotten.

We are also keeping a curated list of pre-installed utility tools that you can use on your slot. When you have familiarized yourself with the guide you are reading right now. The next step would be to check out the list of pre-installed tools, and it can be found here.


In this section, we will detail the commands used to move between directories in Linux; we will also cover how to find your location and the structure of your slot.


The first thing you are going to want to do in your terminal is to navigate between directories. All tasks are performed within different directories, and your current directory affects how a command may run or how you may need to use a command.

When you first SSH into your slot, you will be in your personal home directory. This is the location of all your files; anything you wish to accomplish must be done within the home directory as this is the only folder you have read, write and execute permissions for. If, while navigating your terminal, you wish to return to your home directory, you can do so by typing cd ~.

This brings us to the command you will likely find yourself using a large amount of the time; cd. This command is used to navigate between different directories in Linux and stands for change directory. To use this command, you simply type cd followed by the directory you wish to navigate to.

In Linux, when navigating using the cd command, there are multiple ways to tell the operating system where exactly you want to be. If, for example, you want to move one directory deeper from a directory you are already in, you would use cd [directory]. If you know the directory structure already and you simply want to go to a path relative to your current location, you can use cd path/to/directory where each / stands for a directory deeper. Just like ~ refers to the home directory / refers to the root of the filesystem. If, for example, you wanted to navigate to a folder called media in your home directory, you would use the command cd ~/media.

It is also worth noting that in Linux, . refers to the current working directory and .. refers to the directory above. This is useful in if you want to go back one directory you can type cd .., or if you want to go back two you can use cd ../.. and so on.


Knowing how to navigate your directories is all well and good, but how do you know where you actually want to go? For this, we use the ls command. Typing ls within any directory in Linux will instantly show you all the folders in said directory. You can also use ls to list the directories inside a different directory using ls path/to/directory.


The pwd command is used to show you the exact location you are currently in, fairly simple, really. Running pwd will print the full path to your current working directory. Very useful for when you may be lost.

File and Directory Manipulation

At some point, you are going to want to move files/directories around, copy or delete them. Here we will cover the commands involved in achieving this.


The mv command stands for move; you can use it to move a file or directory to another directory. It is as simple as using the command mv [file or directory you wish to move] [where you wish to move it]. For example, if you wanted to move a directory called media to a directory called files you'd use the command mv media files if, however, you wish to move all the files from the directory called media into the directory called files you'd use mv media/* files this tells the operating system to move all the files (signified by /*) located in media.


The cp command stands for copy; it is used in much the same way as mv; however, there are a few little details worth covering. The general Syntax is the same as mv; if you wish to copy a file in your current directory named Movie1.mkv to a subdirectory called media you'd used the command cp Movie1.mkv media. The difference comes when you wish to copy an entire directory, when you want to copy an entire directory, you need to tell the cp command to copy recursively. This is signified with a -r after the cp. For example, if you wished to copy the directory called media to files similar to the previous example, you'd use the command cp -r media files. Copying all the files within media to files is pretty much exactly the same; cp media/* files. However, if there are any sub-directories within media that you also wish to copy, you again need to use the -r flag; cp -r media/* files. The -r flag is used whenever you need to copy an entire directory.


The rm command stands for remove, it is used to delete files or directories you no longer wish to use. It is very important to keep in mind that there is no recycling bin in Linux, any files you delete are permanently lost. Syntax for rm is much the same as cp if you wish to remove a file named Movie1.mkv you'd simply type rm Movie1.mkv. If you wish to remove an entire directory, once again, you need to use the -r flag; rm -r media would delete the entire media directory. If you wanted to remove all the files inside the media directory, you'd use rm media/* or rm -r media/* if there are directories inside the media.


The unrar command can be used to manually decompress a rar file via SSH terminal. The steps to unrar a file are simple simply cd to a path the rar file is in, for example cd /path/to/rar and run unrar x archive-name.rar This will unpack the rar file in the current folder check the content using the ls command.

Further Info

For any commands, you need to find more information on; you can use the command man [command]. This displays a manual page for the specified command. Specific Commands

Application Management

When interacting with your slot through Secure Shell, you may wish to manipulate the applications we offer one-click installers for; to do this, you use the app-[appname] commands.

Installing and Uninstalling Apps

To install an application, we can use the command app-[appname] install. This can be helpful to gain further knowledge as to why certain installations are failing. When installing an application, you will be presented with an output in the SSH prompt showing either true or false.

Likewise, to uninstall an application, we can use the command app-[appname] uninstall. This is especially useful in the case of an application saying it's installed while not being accessible from the UCP.

Stop, Start and Restarting Apps

To change the running state of an application we use app-[appname] [start|stop|restart]. These commands will be useful for you throughout the usage of your USB slot for troubleshooting or further customize your experience.

Checking Used Space

To display your folder structure and space taken by individual files, the ncdu -x command is included in every slot. After a short scan largest items are displayed top, and size is in descending order

Further Info

For further information regarding specific commands for a particular application run app-[appname] help. This will provide all sub-commands available for the said app.