--- title: "How to get started with SSH connections" description: "Learn how to securely log on to your server with the SSH protocol." url: https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/ssh-introduction lang: en --- > For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt. # How to get started with SSH connections **Learn how to securely log on to your server with the SSH protocol.** The SSH (Secure Shell) communication protocol is the main practice for establishing encrypted host connections through untrusted networks. The OpenSSH utility is available on all OVHcloud servers (VPS, dedicated servers, Public Cloud instances) to allow secure remote server logins and other operations. **Warning:** **NOTE:** OVHcloud provides services for which you are responsible for their configuration and management. You are therefore responsible for their proper functioning.\ \ This tutorial is designed to help you as much as possible with common tasks. If you are having difficulty performing these actions, please contact a specialized service provider. OVHcloud cannot provide you with technical support in this regard.   ## Requirements - A [dedicated server](https://us.ovhcloud.com/bare-metal/) or a [VPS](https://us.ovhcloud.com/vps/) in your OVHcloud account - An SSH client application (command line or GUI) **Note:** This guide does not apply to standard Windows server installations since they rely on the Remote Desktop Protocol for connections. However, SSH connections are used for the OVHcloud rescue mode. You can find more information in the [Go further](#go-further) section of this guide.   ## Instructions There are multiple ways to authenticate a connection to a remote device via SSH. The following instructions will involve the authentication method with **username and password**. You can also configure key-based authentication to enable secure logins without passwords. You can find more details in our guides: - [How to create and use keys for SSH authentication](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/create-use-authentication-keys-ssh-connections-ovhcloud-server.md) - [How to create and use keys for SSH authentication with PuTTY](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/ssh-using-putty-on-windows.md) The login credentials (username and password) are sent to you by email at the first installation or when a server is reinstalled in the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/). The username corresponds to the operating system, for example, `ubuntu` or `debian`. To connect, you also need to specify the IP address or the `hostname` of the server. These details are available in the installation email and the OVHcloud Control Panel. Be sure to consult our "Getting Started" guides as well: - For a [dedicated server](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/getting-started-dedicated-server-windows-linux.md) - For a [dedicated server of the Eco product line](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/getting-started-with-dedicated-server-eco.md) - For a [VPS](https://docs.us.ovhcloud.com/en/bare-metal-cloud/vps/starting-with-a-vps.md)   ### Establishing a connection #### GNU/Linux or macOS A command line client for SSH (OpenSSH) is usually available by default. Open the Terminal application and connect to the server with the following command: ```bash ssh username@server_IP ``` If you have changed the SSH port of the server, use this command instead: ```bash ssh username@server_IP -p port_number ``` #### Windows Recent versions of the Windows OS include OpenSSH, so you can use it directly from the native command line applications (PowerShell or Command Prompt). Right-click on the Windows `Start` button and select `Windows PowerShell`. Alternatively, use the search field to start one of these programs. Connect to the server with the following command: ```bash ssh username@server_IP ``` If you have changed the SSH port of the server, use this command: ```bash ssh username@server_IP -p port_number ```   ### Login and fingerprint When prompted for a password, type the password of the connecting user and press `Enter`. If this is a new connection, your SSH client will receive a **key fingerprint** from the server. Enter "yes" to confirm and then the password of the connecting user to log in. Example output: ```bash ssh ubuntu@203.0.113.100 ``` ```console The authenticity of host '203.0.113.100 (203.0.113.100)' can't be established. ECDSA key fingerprint is SHA256:rRwrdsmJfzvJF5k0a4JmMSdaWbTlCgRKBukbmQ3gmso. Are you sure you want to continue connecting (yes/no/[fingerprint])? Warning: Permanently added '203.0.113.100' (ECDSA) to the list of known hosts. ubuntu@203.0.113.100's password: ``` The fingerprint is then saved on your device and will be verified for each new connection. If the key has changed on the remote host, you will receive a warning message when trying to connect. Example output: ```console @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Host key verification failed. Offending ECDSA key in /home/user/.ssh/known_hosts:3 ``` It means that one of the following has occurred: - The server has been reinstalled. - The SSH service on the server has been reinstalled. - You are connecting to a different host with the same IP address. **Note:** The warning message does not necessarily indicate a security issue. If you have not initiated one of these incidents, the remote server might be compromised. To resolve this issue, follow the steps in the appropriate tab below. #### GNU/Linux or macOS Use the following command with the IP address of your server. ```bash ssh-keygen -f ~/.ssh/known_hosts -R 203.0.113.100 ``` Alternatively, you can edit the `known_hosts` file located in your local user account's `home` folder with a text editor. Example: ```bash nano ~/.ssh/known_hosts ``` #### Windows To resolve this, use the following command with the name of your local Windows user account and the IP address of your server: ```bash ssh-keygen -f "C:\Users\Name_Windows_User\.ssh\known_hosts" -R 203.0.113.100 ``` Alternatively, navigate to this folder, right-click on the file, and open it with a text editor (Notepad, Notepad++, etc.). Locate the "offending" line that was specified in the warning message; in this example, it would be the third one. Highlight and delete the entire line. Save the changes and exit the editor. You will have to confirm the new fingerprint at the next server login.   ### Using dedicated GUI clients or software compatible with SSH If you prefer a graphical user interface, you can find many software applications for every type of OS that enable you to connect to remote hosts via the SSH protocol. For example, [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) is an open-source SSH client software with many user features. Find out how to use it for connections to OVHcloud servers in our detailed tutorial: [How to use PuTTY](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/ssh-using-putty-on-windows.md) #### Click here to see a list of software options for each of the three major operating systems. #### On Windows: - [PuTTy](http://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) (Free) - [MobaXterm](https://mobaxterm.mobatek.net/) (Free Version and Paid Version) - [SecureCRT](http://www.vandyke.com/products/securecrt/) (Paid) For the latest Windows 10 and Windows Server versions, developer mode gives you access to a BASH (Bourne Again SHell) console. For more information, please review Microsoft's [documentation](https://msdn.microsoft.com/en-gb/commandline/wsl/install-win10). #### On MacOS: - The **Terminal** tool is delivered with macOS and is automatically installed on the machine. #### On Linux: - The **Console** or **Terminal** tool is natively installed. - For managing multiple tabs, the **Terminator** terminal emulator can be installed. You can read an Ubuntu manual page for **Terminator** [here](http://manpages.ubuntu.com/manpages/zesty/man1/terminator.1.html). - [OpenSSH](http://www.openssh.com) (Free)   ## Go further [How to configure user accounts and root access on a server](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/configure-user-accounts-root-access-server.md) [How to create and use keys for SSH authentication](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/create-use-authentication-keys-ssh-connections-ovhcloud-server.md) [How to create and use keys for SSH authentication with PuTTY](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/ssh-using-putty-on-windows.md) [Dedicated server rescue mode](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/rescue-mode.md) [VPS rescue mode](https://docs.us.ovhcloud.com/en/bare-metal-cloud/vps/recover-rescue-mode.md) Browse all the [Dedicated Servers guides](https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/landing-page-dedicated-servers.md). Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services. Learn more about [Dedicated Servers](https://us.ovhcloud.com/bare-metal/) on the OVHcloud US website. If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://us.ovhcloud.com/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.