Connect to your Ultra slot via SSH

SSH, also known as Secure Shell, is a network protocol that gives you a secure way to access your Ultra slot remotely. SSH access is included with Ultra plans.

With SSH, you can:

• Access your slot’s shell securely
• Execute remote commands
• Manage files and directories
• Use app-management commands
• Diagnose and troubleshoot problems with your apps
• Use SFTP for secure file transfers

If you are new to the Linux shell, we recommend reading Your Ultra Shell - A Beginner’s Guide after you connect successfully.

Change your SSH Password

Before logging in with SSH, you should first set your own SSH/FTP password from the User Control Panel.

• Log in to the User Control Panel.
• Click Connect on your Ultra service.
• Open the Connect tab.
• Click Change password beside SSH access.
• Set your password.

• When you're done, click Confirm change.
• A popup saying Password successfully changed should appear in the lower-right corner of the page, confirming that the password was set successfully.

SSH Clients and How to Connect

You can connect to your Ultra slot with any SSH client. Common options include:

• OpenSSH
• PuTTY
• Termius

Your SSH connection details are available in the Connect tab of the User Control Panel.

You will need:

Hostname: <servername>.usbx.me or IP address
Username: <your-ultra-username>
Password: <your-ssh/ftp-password>
Port: 22

OpenSSH

OpenSSH is a command-line SSH client available on Linux, macOS, and modern Windows systems.

Install OpenSSH in Windows 10

• OpenSSH Client is included by default on many modern Windows installations. If it is not available, you can install it from Windows Optional Features.
• To check whether OpenSSH is installed, open PowerShell or Command Prompt and run: ssh.
• If the command is recognized, OpenSSH is available.
• To install OpenSSH client, go to Settings then go to Apps > Apps and Features > Manage Optional Features. Then, click Add a feature.

• Then, select OpenSSH Client and click Install.

• Once installation is completed, return to Apps > Apps and Features > Manage Optional Features and you should see OpenSSH Client listed under Optional features.

Install OpenSSH in Linux

Some Linux distributions already include OpenSSH Client. If it is not installed, use the command for your distribution.

Ubuntu/Debian: sudo apt Install openssh-client

Arch Linux/Manjaro Linux: sudo pacman -S openssh

Fedora: sudo dnf install -y openssh-client

Access the slot’s Terminal via OpenSSH

The following screenshots are from Windows' command prompt, but they should be the same on Windows, Linux, and macOS.

• Open up a command prompt window, Windows PowerShell window, or a terminal window (macOS/Linux) and type in either of the following

ssh username@IP_of_slot (your_username@123.456.789)
ssh username@servername.usbx.me (your_username@jupiter.usbx.me)
ssh username@username.servername.usbx.me (your_username@usbdocs.jupiter.usbx.me)

• When you do this the first time, this message appears. This is normal. This means that your computer does not recognize the remote host, which is your slot, and will happen the first time you connect to a new host.
• Type yes and press ENTER to continue. You can compare your IP address shown here to the one indicated to your UCP, and if it's correct, type yes.

• Then, enter the Password that you set earlier. Take note that you won't see anything in the password field as you type. This is normal as no visual feedback of passwords given in the terminal is part of the security measures taken by default.
• When you entered the correct Password, you'll enter the shell of your slot.

PuTTY

PuTTY is a free and open-source GUI SSH, Telnet, Rlogin, and serial port connection client for Windows.

Installation

• Download and install the latest release of PuTTY here.

Set up PuTTY

• Launch PuTTY, and you'll be greeted with this window.

• Login to your UCP and navigate to your Access details Tab.
• Put in the hostname or the IP of the slot to the Host Name (or IP Address) text box. In the screenshot, I'll be using the IP of the slot.
• Make sure that the Port is set to 22 and the Connection Type is SSH.
• In Connection -> Data, enter the username registered on your slot.

• This is optional, but under Connection, you can set Seconds between keepalives to 60. This is to prevent you from disconnecting from your SSH session whenever you're idle.

• Now, to save your profile, go to Session. Enter any name you want on the Saved sessions text box and click Save.

• We will now log in to your slot. Highlight the Saved Session you just made. and click Open.
• Another window will open.
• Enter the Password you set. Once logged in, you'll see this message. You're now in your slot's terminal session.

Termius

Termius is an SSH client available for desktop and mobile devices. It supports saved hosts, multiple devices, SSH keys, and other convenience features.

Installation

• Download and install the latest release of Termius here.

Set up Termius

• Launch Termius, and you'll be greeted with this window.

• click the NEW HOST button in the top Left corner to add a new host.

• Login to your UCP and navigate to your Access details Tab
• Put in the hostname or the IP of the slot to Address field . In the screenshot, I'll be using the hostname of the slot.
• Enter the username & password in the Username & Password field respectively.
• The SSH port will remain 22 which is the default value in Termius.

• Entered details are saved automatically. You can either double click on the created host on the left side or use the connect button on the upper right corner.

• Select Add and continue next.

• Now, you will be greeted with your slot's terminal window.

• To read more about the Termius options in a detailed manner visit here.

Optional: use SSH keys

• Password login works, but SSH keys can be more secure and more convenient.
• With SSH keys, you generate a key pair on your local device:
• A private key, which stays on your device
• A public key, which is added to your Ultra slot
• After setup, you can log in without typing your SSH/FTP password each time.
• For instructions, see the Public Key Authentication guide.

Basic troubleshooting

Connection timed out after failed login attempts

• If you enter the wrong password multiple times, your IP may be temporarily blocked from SSH login attempts.
• This soft ban usually lasts 10 minutes.
• If this happens:
• Change your SSH/FTP password from the User Control Panel.
• Wait at least 10 minutes.
• Try logging in again with the new password.

“Permission denied” error

• If you see a permission error:
• Confirm that you are using the correct Ultra username.
• Confirm that you are using the correct hostname or IP address.
• Reset your SSH/FTP password from the UCP.
• Wait a few minutes, then try again.

If you require further assistance, you can open a support ticket here!

• Connect to your Ultra slot via SSH
• Change your SSH Password
• SSH Clients and How to Connect
• OpenSSH
• Install OpenSSH in Windows 10
• Install OpenSSH in Linux
• Access the slot’s Terminal via OpenSSH
• PuTTY
• Installation
• Set up PuTTY
• Termius
• Installation
• Set up Termius
• Optional: use SSH keys
• Basic troubleshooting
• Connection timed out after failed login attempts
• “Permission denied” error