Linux

Installation

1. If you don't have PuTTY installed, visit the Download PuTTY page and download a Windows installer from the Package files section of the page.
   
   

   If you are uncertain which installer to pick, you should probably download the 64-bit MSI Windows installer.
2. Run the installer and follow the steps.
3. Once the installation is complete, you can launch the PuTTY application and start the configuration.

Configuration

When you launch PuTTY, the main session configuration screen will appear. There are a large number of available options, but most people will only need to adjust a few.

1. Start by entering the Host Name (or IP address) of the server you are trying to connect to.
   1. You can specify the user you want to connect to your server as by adding it before the server hostname followed by an @ symbol so the whole thing looks similar to an email address, like username@some.hostname.com.
2. By default the Port will be set to 22 as this is the standard port for SSH on most servers. Adjust this number as needed.
   1. Our servers often use custom SSH ports to help evade automated hacking tools. The ports are as follows:
      1. Shared or reseller server: 1291
      2. Legacy VPS (KVM/Xen/OpenVZ): 1891
      3. Dedicated servers: 1157
3. Make sure the Connection type is set to SSH.
4. If you're not using a private key to connect to your server and you don't want to save your configuration for later use, you can click Open to initiate an SSH immediate connection to your server to authenticate via your account password.
   • If you'd like to use a public/private key pair to connect to your account and you haven't configured it already, read the SSH Key Authentication section below before continuing.
   • If you'd like to save this configuration for later use before connecting, skip to the Saving your PuTTY Configuration section and follow those directions before returning here.
5. If this is the first time you are connecting to your server, PuTTY will display a Security Alert letting you know that PuTTY doesn't have a key in the registry for this server. This is normal for your first connection.
   1. If everything is OK, click Yes and PuTTY will remember this server in the future and won't warn you about connecting unless the server appears to be different for some reason (in that case you'd see another warning). If you get another warning for a server you know you've connected to before and told PuTTY to remember the server, you should be very careful, since you aren't connecting to the same server.
   2. If you're not sure if this is OK and want to connect anyway, click No and PuTTY will attempt to connect but will prompt you the next time you try to connect.
   3. If you are concerned that this server connection might be compromised for some reason, click Cancel and PuTTY will abort the connection. if you are a customer of HostDime, please contact us and we can help you investigate the issue.

6. A new window will open and if the connection is successful, you will be prompted to enter your password.

   You won't see anything on screen while you are typing your password. Linux servers do not show bullets or asterisks in the password prompt so no one looking over your shoulder can see how long your password is. Press Enter when you are done typing your password.

7. If you typed everything correctly, you'll now be connected to a shell on your server. 

SSH Key Authentication

PuTTY can be configured to use SSH keys as well. SSH keys are a more secure, and often more convenient form of authentication. Please see our SSH Keys article for information on generating SSH key pairs for PuTTY, and uploading them to your server. The following steps have been written assuming PuTTYgen has been used to generate an SSH key pair, and that the public key has already been uploaded to your server and you still have the PuTTY session configuration screen open from following most of the steps in the previous section.

1. In the sidebar of the main configuration screen, click the small + next to SSH to expose more SSH configuration options and then click on the Auth option to view the authentication options.
2. Click Browse... at the bottom of the screen next to Private key for authentication. 
   
3. Select your saved .ppk SSH key file from your local computer.
4. Click the Open button and then continue from step 5 in the Configuration section above to connect immediately, or continue reading the next section to save your configuration for later use.

Saving your PuTTY Configuration

PuTTY allows you to save the configuration you use to connect to a server so you don't have to type all the information in each time as a Session.

1. After you've filled out all the appropriate fields, and are ready to connect, make sure you are in the main session configuration screen mentioned above. You should see your server hostname and port number.
2. Type in a name for your saved SSH session configuration in the text box under Saved Sessions, and click Save.
3. The session you just created will appear in the list below the text box below Default Settings.
4. If you want to connect to your server now, continue with step 4 in the Configuration section above.