Skip to content

Changes

Page history
Update How to set up SSH keys authored by David Benjamin Goll's avatar David Benjamin Goll
Show whitespace changes
Inline Side-by-side
Tutorials/How-to-set-up-SSH-keys.md
View page @ 69f2a614
...@@ -4,6 +4,10 @@ Source information: [Set up a SSH access to the cluster on your local system](ht ...@@ -4,6 +4,10 @@ Source information: [Set up a SSH access to the cluster on your local system](ht
The SSH keys serve as a door/key combination, allowing computers possessing the keys (SSH private key) to log into the server where the door (SSH public key) is placed. You can automate the installation of this "door" by following these steps. The SSH keys serve as a door/key combination, allowing computers possessing the keys (SSH private key) to log into the server where the door (SSH public key) is placed. You can automate the installation of this "door" by following these steps.
## Prerequisites
Make sure your PIK account is granted access to the cluster. If not, please contact your supervisor or the IT.
# How to set up SSH keys on Mac/Linux/Ubuntu # How to set up SSH keys on Mac/Linux/Ubuntu
1. Open a command shell 1. Open a command shell
...@@ -12,8 +16,8 @@ The SSH keys serve as a door/key combination, allowing computers possessing the ...@@ -12,8 +16,8 @@ The SSH keys serve as a door/key combination, allowing computers possessing the
4. Press Enter to accept the suggested location '~/.ssh/id_rsa'. We strongly recommend not to change this location! 4. Press Enter to accept the suggested location '~/.ssh/id_rsa'. We strongly recommend not to change this location!
5. (If you already set up a SSH connection in the past and want to renew - e.g. because you want to change the passphrase: Accept to overwrite the file by entering `y` and pressing Enter.) 5. (If you already set up a SSH connection in the past and want to renew - e.g. because you want to change the passphrase: Accept to overwrite the file by entering `y` and pressing Enter.)
6. Enter your passphrase twice 6. Enter your passphrase twice
7. Upload your public key to the cluster (ssh-copy-id) 7. Upload your public key to the cluster: run the command `ssh-copy-id yourUsername@ts01.pik-potsdam.de` <br>(change yourUsername to your PIK account name)
8. Run the command `ssh-copy-id yourUsername@ts01.pik-potsdam.de` 8. Try to log in via `ssh yourUsername@cluster.pik-potsdam.de`
9. You should see the start page of the cluster. Congratulations! 9. You should see the start page of the cluster. Congratulations!
10. To exit the cluster, run the command `exit` 10. To exit the cluster, run the command `exit`
...@@ -23,12 +27,12 @@ The SSH keys serve as a door/key combination, allowing computers possessing the ...@@ -23,12 +27,12 @@ The SSH keys serve as a door/key combination, allowing computers possessing the
# How to access the cluster # How to access the cluster
- Run the command `ssh [username]@cluster.pik-potsdam.de` - Run the command `ssh yourUsername@cluster.pik-potsdam.de`
- To simplify logging in by just `ssh cluster`, follow these steps: - To simplify logging in by just `ssh cluster`, follow these steps:
1. Open a terminal and navigate to your (local!) home directory by `cd ~` 1. Open a terminal and navigate to your (local!) home directory by `cd ~`
2. Use a text editor to create the ~/.ssh/config file. You can use any text editor you're comfortable with. For example, you can use the nano text editor by running `nano ~/.ssh/config` <br> 2. Use a text editor to create the ~/.ssh/config file. You can use any text editor you're comfortable with. For example, you can use the nano text editor by running `nano ~/.ssh/config` <br>
This command will open the nano text editor and create a new file named config in the ~/.ssh directory if it doesn't already exist. This command will open the nano text editor and create a new file named config in the ~/.ssh directory if it doesn't already exist.
3. Copy and paste the following into the config file. Change the pik_username to your username! 3. Copy and paste the following into the config file. Change the pik_username in the 4th line to your PIK account username!
``` ```
Host ts01 cluster Host ts01 cluster
...@@ -45,4 +49,5 @@ Host ts01 cluster ...@@ -45,4 +49,5 @@ Host ts01 cluster
# How to set up SSH keys on Windows # How to set up SSH keys on Windows
[Follow these instructions](https://www.pik-potsdam.de/members/aaronal/ssh-key-upload-guide/ssh-key-upload-guide-windows) It is recommended to use a Linux-distribution such as Ubuntu instead of Windows. However, if you still want to continue using Windows,
\ No newline at end of file [follow these instructions](https://www.pik-potsdam.de/members/aaronal/ssh-key-upload-guide/ssh-key-upload-guide-windows)
\ No newline at end of file