SSH Connect to Instance
There are multiple methods to connect to a Linux server using SSH. Here, we introduce several commonly used SSH remote login tools. You only need to use one of them to log in to a GPUGEEK instance.
Windows systems can use: XShell, Mobaxterm, FinalShell, as well as CRT and the built-in terminal in Windows 11.
MacOS systems can use: Iterm2, FinalShell, the built-in MacOS terminal, Termius, etc., according to personal preference.
XShell Connect to GPUGEEK Instance
- Windows
1. After installing SSH, open it and click New
2. Go to GPUGEEK Console -> Personal Space -> Instance Management, find the corresponding instance Login, then copy the Login Command and Login Password
Paste them into any file, as follows:
Login Command: ssh -p 11111 root@xxxxxxxx.GPUGEEK.com
Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Command breakdown:
Instance SSH Host: xxxxxxxx.GPUGEEK.com
Instance SSH Port: 11111
Instance Login Username: root
Instance Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
- Field 1: Enter the name of this SSH session (customizable)
- Field 2: Enter your instance’s SSH host
- Field 3: Enter your instance’s port number
- Field 4: Enter the instance username and password
Then click OK
3. Enter the username and corresponding password, then confirm
4. Double-click the added SSH session, then accept and save
5. Double-click the created session to log in to the instance
Mobaxterm Connect to GPUGEEK Instance
- Windows
1. According to marker 1, click Session
2. Then go to GPUGEEK Console -> Personal Space -> Instance Management, find the corresponding instance Login, then copy the Login Command and Login Password
Paste them into any file, as follows:
Login Command: ssh -p 11111 root@xxxxxxxx.GPUGEEK.com
Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Command breakdown:
Instance SSH Host: xxxxxxxx.GPUGEEK.com
Instance SSH Port: 11111
Instance Login Username: root
Instance Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
- Marker 1: Click SSH to configure the SSH connection
- Marker 2: Enter your instance’s SSH host
- Marker 3: Select
Specify usernameto specify the username - Marker 4: Enter the instance login username
- Marker 5: Enter the instance SSH port
- Marker 6: Click OK at the bottom
3. Select marker 1 and click Accept
4. Enter the instance login password
5. Check marker 1 to stop showing the popup, check marker 2 to remember the password
FinalShell Connect to GPUGEEK Instance
- Windows
- macOS
- Linux
Here we demonstrate using the macOS version.
1. Open FinalShell and create a new connection
2. Then go to GPUGEEK Console -> Personal Space -> Instance Management, find the corresponding instance Login, then copy the Login Command and Login Password
Paste them into any file, as follows:
Login Command: ssh -p 11111 root@xxxxxxxx.GPUGEEK.com
Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Command breakdown:
Instance SSH Host: xxxxxxxx.GPUGEEK.com
Instance SSH Port: 11111
Instance Login Username: root
Instance Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. Enter the corresponding information into FinalShell
- Field 1: Enter a custom name
- Field 2: Enter your instance’s SSH host
- Field 3: Enter the instance SSH port
- Field 4: Enter the instance login username
- Field 5: Enter the instance login password
- Field 6: Click Confirm at the bottom
4. Click the created SSH connection
5. Accept and save the key
Successfully logged into the instance
MacOS Built-in Terminal Connect to GPUGEEK Instance
1. Find Terminal in macOS Launchpad, or press command + space to search Terminal
2. Go to GPUGEEK Console -> Personal Space -> Instance Management, find the corresponding instance Login, then copy the Login Command and Login Password
Paste them into any file, as follows:
Login Command: ssh -p 11111 root@xxxxxxxx.GPUGEEK.com
Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Command breakdown:
Instance SSH Host: xxxxxxxx.GPUGEEK.com
Instance SSH Port: 11111
Instance Login Username: root
Instance Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. Directly paste the login command and login password into the Terminal
- Marker 1: Paste the login command
- Marker 2: Paste the login password
Then press Enter to log in to the instance
MacOS Iterm2 Connect to GPUGEEK Instance
- macOS
1. Find Iterm2 in macOS Launchpad, or press command + space to search for Iterm2
2. Go to GPUGEEK Console -> Personal Space -> Instance Management, find the corresponding instance Login, then copy the Login Command and Login Password
Paste them into any file, as follows:
Login Command: ssh -p 11111 root@xxxxxxxx.GPUGEEK.com
Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Command breakdown:
Instance SSH Host: xxxxxxxx.GPUGEEK.com
Instance SSH Port: 11111
Instance Login Username: root
Instance Login Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. Directly paste the login command and login password into Iterm2 terminal
- Marker 1: Paste the login command
- Marker 2: Paste the login password
Then press Enter to log in to the instance
Log in to Instance Using SSH Key
What is an SSH Key
By default, SSH uses password login. This method has many drawbacks: simple passwords are insecure, and complex passwords are difficult to remember. Key-based login is a better solution, as it improves the security of the instance.
SSH key login uses asymmetric encryption. Each user logs in with their own key. The private key must be kept secret and not leaked, while the public key is open and can be shared. Public and private keys are paired: each private key has exactly one corresponding public key, and vice versa.
If data is encrypted with the public key, only the corresponding private key can decrypt it. Conversely, if the private key is used to encrypt (this process is generally called “signing”), only the corresponding public key can decrypt it.
The steps of SSH key login are as follows:
- Preparation: The client generates its public and private keys using
ssh-keygenor an SSH tool. - Manually place the client’s public key in the specified location on the remote server.
- The client sends an
SSHlogin request to the server. - The server receives the request, sends some random data to the client, and asks the client to prove its identity.
- The client signs the data using the private key and sends it back to the server.
- The server uses the corresponding public key to verify the signature. If it matches the original data, the client is allowed to log in.
Generate Key on Local Computer
On Windows: right-click the desktop to open a terminal, or open CMD command line, then generate the key
On macOS: use Terminal or iterm2 tool to generate the key, command is the same as below
PS C:\> ssh-keygen -t rsa -b 4096
Generating public/private rsa key pair.
Enter file in which to save the key (C:\Users\Administrator/.ssh/id_rsa):
Created directory 'C:\Users\Administrator/.ssh'.
Enter passphrase (empty for no passphrase): # just press Enter
Enter same passphrase again: # just press Enter
Your identification has been saved in C:\Users\Administrator/.ssh/id_rsa. # path of the private key
Your public key has been saved in C:\Users\Administrator/.ssh/id_rsa.pub. # path of the public key, copy this path, you’ll need it below
The key fingerprint is:
SHA256:A5a+48LNoHEidLAHGYUYaW4d/1m98Hun1V76LTgtOT0 Administrator@Administrator
The key's randomart image is:
+---[RSA 4096]----+
|o+=. |
|o* . . |
|o = o + . |
| = + + . o . |
|o o o S o . |
|. o o + . o .|
| . * +o .= .o|
| . o.o. .*.E+o|
| .. .=+++|
+----[SHA256]-----+
View and copy the generated public key
PS C:\> cat C:\Users\Administrator/.ssh/id_rsa.pub.
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDEOOeSSTM7vMu2SDm42G5oUwW6ApNaDUp77JNT47q0DbhoJ4kcVwKRxzoTdp+xT4d4RHPkSu/9RRgD5V/s+oE6AmyRMjMPIjb7svdBabxlze7c4OY7LzGX2+g7B9Ghh6KY7OQG6DkvYoKSdbfWNfMZ3aLVrU/37DpfwtCJRujdB3eNGP8wef5HXlNbgXweAnQ74G+H8k3l6zyqN2IiFrnfXA2uBIpgXFdon/RG8+exG9obEogNmiAC77nrJnvvofVSX2tXdcK5KufzudZKlyE3OCuCCZNqs1u85qlMz/Deg1aoRSr7gsKdMdya1r5wGQi5Ur7NSp8pOsk0Ff/udNGB5bC/51o4bZgTklZrSSbwd2ahFYV9mXSFmp3Z/bYZO7qLHJfi1X18svvBsEjJ1AspstbTO+QTXpw8+MFTwveaUFVaPCPBru7fOpMiF7e2W5ZMc2XRUhFhD6welTSIEzhukU3SxA5Yzr8p2WpWrxwOCkANLJYRUVVOwOQWAMJJK1CKbVe+7j3OA Administrator@Administrator
Configure Local Public Key on the Platform
Log in to the GPUGEEK platform and fill in the local public key
Go to Personal Space -> Account Center -> Add -> then enter the generated public key above, and click Confirm.
The display after adding is as follows:
Create Instance and Log in with Key (Terminal Method)
After adding a key, only newly created instances can use key login. Instances created before adding the key cannot use key login.
For how to create an instance, see Create Instance.
After the instance is created, log in from the terminal (Windows terminal, macOS Terminal, or iterm2) using key-based login. You can log in without a password, as shown below:
PS C:\> ssh -p 60185 root@xxxxxxxxxx.GPUGEEK.com
Create Instance and Log in with Key (XShell Method)
After adding a key, only newly created instances can use key login. Instances created before adding the key cannot use key login.
For how to create an instance, see Create Instance.
Open XShell, then create a new connection, and enter the corresponding information in the following order.
Then in Step 5 User Authentication, enter the username and select the Public key method.
Click Tools -> User Key Manager.
Select Import.
In the address field, enter the path of the previously generated key, then select id_rsa (private key) and open it.
Import the private key into XShell to let XShell manage it. After success, it will display as shown below.
Double-click the added machine on the left to log in using the key.