diff --git a/handbook/putty/putty.html b/handbook/putty/putty.html index f814de1c4..507188842 100644 --- a/handbook/putty/putty.html +++ b/handbook/putty/putty.html @@ -16,9 +16,31 @@ on Windows which requires PuTTy. Then run PuTTy;

+

First download and install the PuTTy installer PuTTy. +Then run puttygen, pageant and then PuTTy itself.

+ +

Puttygen:

+

Online documentation for running puttygen is on +putty/0.77/htmldoc/Chapter8.html. +Just use the defaults for key type and key length. After you have pressed the "Generate" button and generated your key, write your own name and date in the box +labelled "Key comment" instead of the default value (which will be something like "rsa-key-20220614"), e.g. "2022-06-14 gussie finknottle" +

Then press the "Save private key" button and save the .ppk file somewhere safe that you can find it again, and back it up somewhere safe too. +You will need it when you configure pageant. + +

pageant

+

pageaent is installed along with PuTTy and is what you need to keep your Windows machine talking nicely to the expo server. +See pagengt config for how to do this. + +

Online documentation is on putty/0.77/htmldoc/Chapter9.html. +

On a Windows 10 machine, sometimes pageant forgets your key. It continuously runs in the background so you need to bring it into view (click on the +icon in the system tray) and "Add key" again. + +

Now return to the key-pair setup instructions for how to configure the key you generated on the expo server. +

PuTTy:

+

Again, for those who skipped the paragraph above, you need to set up set up the keys first using +puttygen.

Upon opening PuTTy, you'll be greeted with a screen similar to this;

@@ -41,9 +63,6 @@ point you select 'hells-to-the-yeah', or equivalent).

You have now made sure that your computer will be happy to log on to the server once you have the keys set up (be sure to use the Windows instructions for this, not the Linux of Windows WSL instructions). To log out of PuTTy, type 'logout', then press the return/enter key.

-

pageant

-

pageaent is installed along with PuTTy and is what you need to keep your Windows machine talking nicely to the expo server. See pagengt config for how to do this. -

Now return to the key-pair setup instructions for how to configure the keys using PuTTy.

Alternative: OpenSSH

There is a recent alternative: use OpenSSH which is now part of Windows 10. See WinLaptop config. But you need to read that anyway.