# Windows(PuTTY)

## Key Generation & Setup

1. Open PuTTYgen (this comes as part of the [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) package), change the 'Number of bits in a generated key:' to 4096 (recommended), then click 'Generate'

   ![Screenshot of the PuTTY Key Generator. No keys have been generated and the 'Generate' button is selected.](/files/-MMVwRzEu78iIwQlIfhb)
2. Move your cursor around randomly in order to "salt" your key, while the key is being generated. Once the key is generated, you should see something like this:

   ![Screenshot of the generated key output. RSA key and key fingerprint are generated, and placeholder for comment and passphrase inputs are shown.](/files/-MMVzQzC0rMMH7smTMIn)
3. Replace the text in the 'Key comment:' field with something recognizable and enter a passphrase in the two fields below.
4. Copy the text in the 'Public key for pasting...' field (the text continues past what is displayed) and paste it wherever the public key is needed. If you are using GitHub, you can now create a new SSH key in your Personal Settings and paste this text into the 'Key' field.
5. Click on 'Save private key' and select a logical/recognizable name and directory for the file. Your private key is saved in the selected file.
6. Open Pageant (also part of the PuTTY package). If a message saying "Pageant is already running" is displayed, open your system tray and double click on the Pageant icon.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>To open your system tray, click on the up arrow (looks like: ^ ) icon at the bottom right of your screen (assuming your taskbar is at the bottom of your screen).</p></div>

   ![Screenshot of the Pageant Key List showing your generated key with options to add and remove keys.](/files/-MMW5GDblpyz6FGUcr0n)
7. Click on 'Add Key' and select the file you saved when generating your key earlier (Step 5). If it is requested, enter the passphrase you created at Step 3 to complete the process.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>In order to not have to add the key to Pageant after every time your machine reboots, you can add the key file(s) to your Windows startup folder (the directory for the current user is C:\Users\[User Name]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup). You may still be prompted to enter the passphrase after a reboot, but you will not have to find and add the key to Pageant every time.</p></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ccv.brown.edu/oscar/connecting-to-oscar/ssh/ssh-key-login-passwordless-ssh/windows-putty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
