diff --git a/doc.zih.tu-dresden.de/docs/access/ssh_putty.md b/doc.zih.tu-dresden.de/docs/access/ssh_putty.md new file mode 100644 index 0000000000000000000000000000000000000000..1da10db46b48baf16f7d1d4284622c4b64a80f3d --- /dev/null +++ b/doc.zih.tu-dresden.de/docs/access/ssh_putty.md @@ -0,0 +1,77 @@ +# Connecting from Windows with PuTTY + +PuTTY is a free and open-source terminal emulator, serial console and network file transfer application, supports several network protocols, including SCP, SSH. Visit its homepage for more information (https://www.putty.org) + +## Download and install + +To download go https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html + + + +Pick the installer suiting best your current system and run it afterwards. Follow the instructions. + +## Quickstart a new SSH session + +1. Start PuTTY and insert the `Host Name` (taurus.hrsk.tu-dresden.de) and change the `Port` (22) if needed. + + + +2. Click "Open" to start a new session. A Terminal will open up as new window. This action will do +basically the same as using the command `ssh taurus.hrsk.tu-dresden.de:22` in Terminal. + + + +3. After inserting your user name ("marie" in this example) and your password, it will log you in. You can start working on HPC. + +## Configured start a new SSH session + +You can preconfigure some values. It will save your time during your connections in the future. + +1. Define the connection target. To do so, start PuTTY, define the hostname (taurus.hrsk.tu-dresden.de) and the port (22). + + + +2. Set your user name. For that choose the tab `Connection` → `Data` in the navigation tree on the left. +Insert your user name into the text field `Auto-login username`. +The application will basically perform the same action as the command `ssh marie@taurus.hrsk.tudresden.de:22` in Terminal. + + + +3. Set a SSH-key (optional and recommended for security reason). + + **Note**: For being able to use a SSH key to login to HPC, you have to register the key on the + system before! + + Add the public-key to `~/.ssh/authorized_keys` and use the following format. + + ```console + # <key-type> <public key> <comment> + ssh-ed25519 <public key> myuser@mylocalhost + ``` + + To configure the SSH key to use, navigate to `Connection` → `SSH` → `Auth` in the tree left. + You will see a text field for `Private key file for authentification`. + Insert the path to your local key-file or brows it using the button `Browse...`. + This will do the same as the command `ssh -i .ssh/id_red25519 marie@taurus.hrsk.tudresden.de:22` in Terminal. + + + +4. Enable X-forwarding (optional). To do so, navigate to `Connection` → `SSH` → `X11` in the tree left. Put the tick in the checkbox for `Enable X11 forwarding`. + + + +1. Save your configurations. Go back to the `Session` in the tree left. Insert a name into the text field `Saved Sessions` and click +the button `Save`. Afterwards you will see the name in the list below. + + + +Now, you can start a configured session by double-clicking its name in the list. + +You can change your saved configuration by selecting its name in the list and clicking the button +`Load`. Make your changes and save it again under the same name. This will overwrite the old +configuration permanently. + +You can delete a saved configurations by clicking the button `Delete`. This will remove the +configured session permanently. + +**Enjoy!**