PuTTY SSH Client for Windows: Easy Quickstart Guide

PDF download Download Article
The complete guide to installing PuTTY and making SSH connections
PDF download Download Article

PuTTY is a free Windows app that lets you make a secure connection to a remote computer. One of the most common uses for PuTTY is to open a secure shell (SSH) connection to a remote Unix server, such as a Linux-based web server. PuTTY also comes with a secure FTP client (SFTP) called PSFTP, a secure file-transfer tool, and PuTTYgen, a tool you can use to generate public and private SSH keys. This wikiHow guide will teach you how to securely connect to another computer using PuTTY on Windows, and how to use other PuTTY tools to create keys and transfer files.

Things You Should Know

  • You can use PuTTY to connect to school servers, work servers, and web servers securely via SSH.
  • PuTTY is available for Windows from https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html .
  • If the server you're connecting to requires your public key, you can generate your public/private keypair in PuTTYgen.
Section 1 of 4:

Installing PuTTY

PDF download Download Article
  1. Go to https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html . PuTTY is a free tool for making secure shell (SSH) connections to a remote server. If you were asked to connect to a certain server via SSH (for your website, for work, school, or any other reason), PuTTY is the most straightforward way to connect on Windows.
  2. All the different files may seem confusing, but there’s no need to worry! In the "MSI (Windows Installer)" section, you'll see three download links—64-bit x86, 64-bit Arm, and 32-bit x86. [1]
    • First, you'll need to figure out which file to download by finding your computer's bit count . Open the Windows Search bar, type about , and then click About your PC . Look at the number next to "System type" in the right panel.
      • If you see "64-bit operating system, x64-based processor," you need the 64-bit x86 version. Download the file called putty-64bit-0.78-installer.msi .
      • If you see "64-bit operating system, ARM-based processor," you need the ARM version. Download putty-arm64-0.78-installer.msi .
      • If you see 32-bit operating system, you need the 32-bit version. Download putty-0.78-installer.msi .
    Advertisement
  3. Double-click the installer you downloaded (it'll be in your default Downloads folder ), then follow the on-screen instructions to install PuTTY. Just choose the default settings and you'll be okay. PuTTY, PSFTP, and PuTTYgen will be added to your Start menu once the installation is complete.
    4. Advertisement
Section 2 of 4:

Connecting to a Server

PDF download Download Article
  1. Most people won't need much information to connect to a server with PuTTY. You'll typically need:
    • The hostname or IP address you want to connect to. A hostname looks like a string of words, like students.harvard.edu or mywebsite.com. An IP address is usually 4 numbers connected together, like 10.0.01.
    • The port you'll need to connect to. If your work, school, hosting provider, or other party hasn't provided you with a port, don't worry—this just means you'll use the default SSH port of 22.
    • Your username and password for the server.
    • If you're connecting to a server that has other requirements, such as using a certificate or private key to authenticate, you'll need those files as well.
      • Most people won't need to do this, but if your host requires you to do so, you can use PuTTYgen to generate a key for your remote server.
  2. It'll be in the Start menu, but you can also type putty into the Windows Search bar to find it quickly. PuTTY will open to the "PuTTY Configuration" screen.
  3. After you start up PuTTY, a dialogue box will pop up on your screen.
    • Enter the hostname or IP address you want to connect to into the first field.
    • SSH is selected by default, which sets the "Port" field to 22. If you need to SSH to a different port, enter that port into the "Port" field.
      • You can also use PuTTY to telnet into remote servers or check ports , but because telnet isn't secure, it's not used much anymore.
    • Type a name for your profile under "Saved Sessions" and click Save . This makes it so you can quickly select this host in the future.
    • If your host requires you to use a private key or certificate, expand the SSH menu, then expand the Auth menu, and select Credentials . Click the Browse… button next to the authentication type your server uses (Private key file and/or Certificate) and select the key or certificate file.
  4. Once the connection is successful, you'll be prompted to enter your username and password to log in. You can now run any Unix commands allowed by your system administrator.
    • Some sysadmins tighten security by making you SSH into one server just to SSH into another. If you need to SSH into another server from the one you just logged into, use ssh -l username remotehostname .
    • If you didn't save a profile, you'll be prompted to do so now. Click Yes or No when prompted.
    5. Advertisement
Section 3 of 4:

Generating Keys

PDF download Download Article
  1. If you were instructed to create an SSH key pair before connecting to the server via SSH, you can do so easily using PuTTYgen. Type puttygen into the Windows search bar, then click PuTTYgen to launch the tool.
    • Use this method if your system administrator or host asked you to provide them with your public key. Once you create your public key and give it to your sysadmin, they'll add it to a file that makes it possible for you to connect with PuTTY.
  2. You can create RSA, DSA, ECDSA, EdDSA, or SSH-1(RSA) keys. RSA is selected by default, as it's the most common type of key.
  3. You'll see this button next to "Generate a public/private key pair."
  4. Keep moving the cursor until the progress bar turns completely green. When the bar is filled, your public key will appear.
  5. Don't skip this step, as it's important for security. Enter and confirm a new passphrase to use when connecting to the remote server with your key. [2]
    • Click Save public key , choose a location you'll remember, call the file something like publickey.pub , and click Save .
    • Then, click Save private key , and save it to a location you'll remember. This time, keep the default file extension of .ppk so you'll remember that the file is your private key.
  7. The process to add your public key to the SSH server will be different on each server, but you'll usually have to upload it to a specific location using a web portal or FTP . You may need to copy it from the "Public key for pasting" field in PuTTYgen into an email so your sysadmin can add it. If you were instructed to add the key yourself, the default location for public keys is in your home directory at ~/.ssh/authorized_keys .
    • If the file does not exist, you can create it in your home directory.
    • If the file does exist and already contains a key, you can use a text editor like nano to paste your key on the line directly below the existing key.
  8. Once your public key is in the right place, you'll need to associate your private key with the connection to the server. If you've already saved your server information, select that server now. If not, enter the hostname and login information for your server, name the connection, and click Save to create one.
  9. You can get here by expanding each of these menus in the "Category" section on the left side of PuTTY.
  10. Choose the private key file you generated (the one that ends with .ppk).
  11. As long as your keys match, you'll be prompted to enter your passphrase and log in to the server via SSH.
    12. Advertisement
Section 4 of 4:

Transferring Files with PSFTP

PDF download Download Article
  1. PuTTY comes with a secure FTP app that lets you transfer files between your computer and a remote server. You'll find PSFTP in the Start menu.
  2. Replace hostname with the host name or IP that you need to connect to. A host name follows the format students.harvard.edu, while an IP address looks like this: 10.0.01.
  3. This initializes the connection to the server.
    • If you are prompted to store a key in your cache, type y .
  4. Use the username and password you were assigned for this server. Once you're logged in, you'll see a prompt.
  5. You'll use the cd command, which means "change directory," to do so. Type cd folderpath and press Enter . Replace folderpath with the path to the remote folder you need to access.
    • For example, if you want to upload a new HTML file to a folder called www in your home directory, type cd www and press Enter .
    • You can run the pwd command to view files in the remote folder. If the remote file is running a flavor of Unix, use ls to list the files in the folder.
  6. This time, you'll use the lcd command, which means "local change directory." Type lcd folderpath , replacing folderpath with the full path of the folder.
    • To see a list of files in the current folder, type !dir and press Enter .
  7. The command is a little different depending on what you want to do. When the transfer is complete, you'll return to the prompt.
    • For example, if you want to upload a file that's in your Documents folder, type cd Documents or C:\Users\yourname\Documents .
    • To upload the file to the remote server, type put filename (replacing filename with the file's real name) and press the Enter key.
    • To download a file, type get filename (replace filename with the actual file name) and press Enter .
    8. Advertisement

Expert Q&A

Ask a Question
200 characters left
Include your email address to get a message when this question is answered.
Submit
      Advertisement

      Tips

      • If you're new to SFTP, you might want to try an app with a graphical user interface (GUI), as it's a lot easier to use. Check out apps like Filezilla and CuteFTP.
        Thanks
        Helpful 0 Not Helpful 0
      • Only download the PuTTY software from its official website. If you find PuTTY software anywhere else, download it at your own risk.
        Thanks
        Helpful 0 Not Helpful 0
      Submit a Tip
      All tip submissions are carefully reviewed before being published
      Name
      Please provide your name and last initial
      Submit
      Thanks for submitting a tip for review!
      Advertisement

      You Might Also Like

      How to
      Find Your Email’s Incoming and Outgoing Mail Servers
      How to
      Use a Proxy
      How to
      Set up a Personal Web Server with XAMPP
      How to
      Connect to a Proxy Server
      How to
      Change Proxy Settings
      5 Simple Steps to Reclaim a Plex Server
      How to
      Create a Proxy
      How to
      Check Error Logs in PuTTY
      How to
      Make a Private RuneScape Server
      How to
      Set Up Vuze with VPN and Socks Proxy Properly
      How to
      Enter Proxy Settings in Firefox
      How to
      Block Proxy Websites
      How to
      Create a Discord Roleplay Server
      How to
      Design a Server Room
      Advertisement

      References

      1. ↑ https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
      2. ↑ https://the.earth.li/~sgtatham/putty/0.68/htmldoc/Chapter8.html#pubkey

      About This Article

      Article Summary X

      1. Download PuTTY from Putty.org.
      2. Double-click the installer to run it.
      3. Open PuTTY from the start menu.
      4. Enter the information for the remote host.
      5. Click Open .
      6. Sign in with your account on the remote server.

      Did this summary help you?
      In other languages
      Thanks to all authors for creating a page that has been read 72,311 times.

      Is this article up to date?

      Advertisement