PuTTY is a free and easy to use ssh client for Windows (7 and 10). You can use it to connect to your favorite remote Linux servers in text mode, and start remote graphical applications if you also have a running X server

Download and install the latest version of PuTTY

You could directly launch PuTTY, but it is actually more efficient to launch Pageant, especially if you are regularly going to connect to the same server(s)

Start ⇒ PuTTY ⇒ Pageant

• It will seem that nothing happens, but you should get the Pageant icon at the bottom right of your screen.
  
  Pageant will allow you to create or use existing connection profiles (Sessions), and also easily use ssh keys (more on ssh keys later)

• If you right click on the Pageant icon, you can manage sessions with the New Session option, use Saved Sessions profiles and manage ssh keys (View Keys, Add Key).
  You can also view/add keys by double clicking on the pageant icon
  

Launch the session/configuration manager: (Right click on) Pageant ⇒ New Session

• You can keep most PuTTY's default settings. This section will show you how to create your first session profile, with some useful options. If you want to add another session later, just Load an existing (and properly configured) session, Save it under a new name, and the change the session details

• When changing a setting, select a (sub-)Category in the left part of the PuTTY Configuration windows, and change the displayed settings in the right part of the window.

• After changing the settings of an existing Session, do not forget to go back to the Session category and click Save!

In the Session category:

• Specify a Host Name: e.g. ssh1.lsce.ipsl.fr for the LSCE access server
• Specify a matching session name in Saved Sessions: e.g. ssh1
• Click on Save to save the session
  

If you are in a hurry, you can connect to the Linux server by clicking on Open, but you should first change some useful settings

• In the Windows ⇒ Selection category:
  • Select xterm for the mouse buttons behavior. This will allow you to use the mouse buttons in the Putty terminal the same way you would use them in an standard Linux xterm terminal: Copy text with the left button, and Paste it with the middle button
    
• In the Connection ⇒ Data category:
  • Specify your login name in Auto-login username. This way you won't have to type it when you connect to the Linux server
    
• In the Connection ⇒ SSH ⇒ Auth category:
  • Select Allow agent forwarding. This is the same as using ssh with the -A option
    
• In the Connection ⇒ SSH ⇒ X11 category:
  • Select Enable X11 forwarding. This is the same as using ssh with the -X option
    

• When you have finished updating settings, do not forget to go back to Category ⇒ Session and Save the session!
  

• Select an existing session (e.g. the ssh1 profile defined above) and click on Load
• Update the values of the Host Name and Saved Session (the name of the new profile you want) text fields, and settings
  e.g. for connecting to LSCE from INSIDE LSCE use:
  • Host Name ⇒ obelix
  • Saved Session ⇒ obelix (direct connection)
• Go back to Category ⇒ Session and Save the session

• Select an existing gateway session and click on Load.
  For connecting to LSCE from OUTSIDE LSCE, select the ssh1 profile
  If you are at LSCE, but use the eduroam or the guest WiFi network, you are considered as being outside LSCE!
• In the Connection ⇒ SSH category, specify the command used to connect to the target server in the Remote command field
  e.g. for LSCE, use
  • ssh obelix
  • or ssh -X -A obelix (check the useful ssh options for more details)
    
• Go back to Category ⇒ Session, specify a new profile name in Saved Sessions (e.g. obelix via ssh1) and Save the session
  

Note: PuTTY will ask your password each time you open a session, unless you have ssh keys, and you use Pageant to store your passphrase

Once you have started pageant, and configured sessions, you can easily open terminals on the remote servers by right-clicking on the pageant icon, and selecting a Saved Session.

It is also possible to create a shortcut on the desktop to start a specific session!

• Right-click on the desktop and select New ⇒ Shortcut
• Specify the location of putty.exe: C:\Program Files\PuTTY\putty.exe
• Specify the name of the shortcut, and save the shortcut
  e.g. obelix via ssh1
• Right-click on the shortcut and select Properties, then add the name of the desired profile to the existing target
  e.g. “C:\Program Files\PuTTY\putty.exe” -load “obelix via ssh1”
• Click OK to save the changes
• You can now connect to the remote server just by clicking on the shortcut!

Read the Using ssh keys section if you don't know what ssh keys are

[ PMIP3 Wiki Home ] - [ Help! ] - [ Wiki syntax ]