How to Connect to Your GPU Instance with OpenSSH

To connect to your GPU instance, you first need to open a terminal. The steps depend on your operating system:

• Linux: Search for Terminal or press CTRL + ALT + T.
• macOS: Search for Terminal.
• Windows: Open PowerShell. If OpenSSH is not installed by default, refer to Microsoft’s documentation to enable it, or use PuTTY as an alternative.

Once the terminal is open, run the SSH command below. Replace your_username with the user account on the server, and replace the IP address after the @ symbol with the IP address of your GPU instance.

ssh use_your_username@203.0.113.0

If multiple SSH keys are present on your system, you may need to explicitly point to the correct private key by using the -i option, as in ssh -i /path/to/private/key username@203.0.113.0. When connecting for the first time, your local machine does not yet recognize the server, so you will be asked to confirm the connection. Type yes and press ENTER to proceed.

The authenticity of host '203.0.113.0 (203.0.113.0)' can't be established.
ECDSA key fingerprint is SHA256:IcLk6dLi+0yTOB6d7x1GMgExamplewZ2BuMn5/I5Jvo.
Are you sure you want to continue connecting (yes/no)? yes

After the initial connection, the server’s host key fingerprint is stored on your local system, and you will see a confirmation message indicating that the key has been added.

Warning: Permanently added '203.0.113.0' (ECDSA) to the list of known hosts.

You may encounter a warning about a remote host identification mismatch. This typically occurs if a GPU instance was deleted and a new one was created shortly afterward using the same IP address. In this situation, your local system still has the host key from the previous server, which no longer matches the new instance.

To resolve this issue, remove the outdated host key from your local machine by running the command ssh-keygen -R 203.0.113.0, replacing the IP address as needed.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.

The next step in the connection process is authentication. If SSH keys are configured for the GPU instance, the connection will complete automatically, or after you enter the passphrase associated with your key. If SSH keys are not set up, the GPU instance will instead prompt you to enter the account password to continue.

username@203.0.113.0's password:

While typing your password, the terminal does not show any characters on the screen. For this reason, it is often easier to paste the password instead of typing it manually. Paste behavior varies depending on the operating system and terminal you are using:

• Linux (GNOME Terminal): Press CTRL + SHIFT + V
• macOS: Press SHIFT + CMD + V or use the middle mouse button
• Windows (Bash): Right-click the window title bar, select Edit, then choose Paste. You can also right-click to paste if QuickEdit Mode is enabled. After entering the password, press ENTER to continue. Because passwords sent via email are not secure, you will be prompted to change the default password immediately after logging in for the first time.

Changing password for username.

To proceed, you will be asked to enter the current password again. Type the password and press ENTER. As before, no characters will appear on the screen while you are typing.

(current) UNIX password:

Next, type your new password and press ENTER. The terminal will not show any characters while you enter it. When prompted, enter the same password again to confirm that it was typed correctly.

Enter new UNIX password:
Retype new UNIX password:

After a successful login, you will see a welcome message specific to the operating system running on the GPU instance. The command prompt updates to show the account you are logged in with, followed by the hostname of the instance, formatted like username@hostname:~#.

If you experience issues connecting to your GPU instance over SSH, you can review common SSH errors or use the Recovery Console to restore normal SSH access.