Tutorials/How-to-connect-VS-Code-with-Cluster.md

+# Important note
+If you use the VSCode Remote SSH extension, do not use cluster.pik-potsdam.de as the hostname. Instead, pick one of login01.pik-potsdam.de or login02.pik-potsdam.de. When ending a session, press CTRL + SHIFT + P and select “Kill VS Code Server on Host…” and select the same host.
+
+This is because “cluster” is an alias for one or other of the login nodes, selected based on which node has the lowest current load. Repeated connections to “cluster” via the Remote SSH extension fail to reuse existing vscode-server processes, which then accumulate over time. (Exerpt from [Connection failures when using VSCode Remote SSH Extension](Troubleshooting/Problems with solutions/Connection failures when using VSCode Remote SSH Extension))
+
 # How to connect
 
 1. Open VSCode
 2. Install the "Remote - SSH" extension
-3. On the left via "Remote Explorer", you should be able to connect to the cluster if you have have previously established a SSH connection
-4. Once connected, you should see the connection on the bottom left
-
 ![Screenshot_2024-05-07_at_17.55.48](uploads/8163e0fab7f27e4299f7f477b4f2322e/Screenshot_2024-05-07_at_17.55.48.png)
 
-![Screenshot_2024-05-07_at_17.59.29](uploads/bde59d2c377352d4f9a8e8c36343c533/Screenshot_2024-05-07_at_17.59.29.png)
+3. On the left via "Remote Explorer", you should already be able to connect to the cluster if you have have previously established a SSH connection. **If you use the VSCode Remote SSH extension, do not use cluster.pik-potsdam.de as the hostname. Instead, pick one of login01.pik-potsdam.de or login02.pik-potsdam.de.**
+  - in VSCode open the ssh remote commands via the shortcut `F1`, 
+  - `Remote-SSH: Add New SSH Host...`, 
+  - enter specific host via `ssh username@login01.pik-potsdam.de` or `ssh username@login02.pik-potsdam.de`
+  - select where to store your private key (.ssh/config on your local computer)
+  - now you should be able to connect to a specific host
+
+![image](uploads/b03caae1a52a1e781f5824d75851781c/image.png)
+
+![image](uploads/04c61b224cc8be6b9c4f9eba4bbd82a8/image.png)
+
+![image](uploads/902de4d58805ff0dba98b1e7b0e70f88/image.png)
+
+
+
+4. Once connected, you should be able to connect via the Remote Explorer to the left and see the connection on the bottom left
+
+![image](uploads/6790c69ad48dc15dfcb279a8f7f11ac7/image.png)
 
-![Screenshot_2024-05-07_at_18.00.05](uploads/4747aa7a3763ba65566da23dabe7f35a/Screenshot_2024-05-07_at_18.00.05.png)
+![image](uploads/c7bf2fc6baa06203ea5f81936b94e765/image.png)
 
 # First example run on the cluster using VS Code
 
@@ -17,4 +36,4 @@
 - create a new .py file in VSCode 
 - run the file on the cluster using commands in the terminal 
 
-![Screenshot_2024-05-08_at_09.47.32](uploads/f04cd32310b17fd7f3db4d9b24c60e05/Screenshot_2024-05-08_at_09.47.32.png)
\ No newline at end of file
+![image](uploads/04a2a306ab36ae93fb019f2b459530aa/image.png)
\ No newline at end of file