Remote-development-using-VS-Code.md

+# Introduction
+
+Work remotely using [VS Code](https://code.visualstudio.com/). This allows you to quickly get up and running with ROS and the system you're developing, without having to install anything on your own computer besides VS Code. Neat! In essence, you will sit on your computer while the other computer (remote) does the work of running ROS, Docker, etc.
+
+Head over to [VS Code](https://code.visualstudio.com/) and download and install it.
+
+# Figure Out the Remote
+
+Look at the IP table for the remote IP for "fetdatorn" [here](https://gitlab.liu.se/liuhomewreckers/liu-home-wreckers/-/wikis/Home). This is the **connection string** you will use when adding the remote using **ssh**.
+
+# VS Code Setup
+
+Given that you now have installed VS Code you are ready to proceed to the next steps.
+
+1. If you have already done this setup before, you may find that the remote setup is available through your recent projects as follows, otherwise skip this step. ![image](uploads/88b65e3c4129522cf6258b3ca952c140/image.png)
+2. Begin by installing the Remote Connection plugins from the store. You can install them by clicking the Extensions icon in the left navigation bar, or by the keyboard shortcut **Ctrl + Shift + X** (Windows).
+
+![image](uploads/4f8a0a02de04d146f4a022041e9402d5/image.png)
+
+![image](uploads/9121ab8d2b1c0e2741982089e0e2ee2d/image.png)
+
+3. Click on the remote extension and add an SSH target.
+
+![image](uploads/7b9649d8e11e8096e67adbc93f62246f/image.png)
+
+4. 
+
+Click **configure** and then add the hostnames under the headline "Using VS Code" from [here](SSH%20Tunnel%20Settings) and replacing the usernames.
+
+![image](uploads/668dfb78d948454841165c183cba7d6e/image.png)
+
+Save the file, and the target should appear in your SSH Targets list.
+
+5. Connect to the host in the current window or a new window.
+
+![image](uploads/7e18ab4b48b870ae79fed67ae7d2805a/image.png)
+
+6. Enter the necessary passwords.
+
+![image](uploads/4d6bb91ccfc64e47c316e1e69d9ec7a3/image.png)
+
+![image](uploads/6ad945651923ddb892ab0acb97f4630b/image.png)
+
+7. Look at the bottom left to see the status of the connection. ![image](uploads/15d61a99996f16b927af802c0b815a1f/image.png) 
+
+   <details><summary>Troubleshooting</summary>
+If you're having trouble connecting after entering your password and get: "Failed to parse remote port from server output" error messages, try downgrading the "Remote - SSH" VSCode extension to 0.49. You might also have to disable compression in the .ssh/config file.
+</details>
+8. Open the repository folder on your user. If you don't have the repository, open your home directory and clone the repository using the terminal (`git clone git@gitlab.liu.se:liuhomewreckers/liu-home-wreckers.git`), and then open that directory instead.
+
+Click on **Open Folder** in the top left to choose the directory to open if you have already cloned the repository into your home folder. ![image](uploads/c0697bf3bb2dd8ee9b29a4a26c982a6a/image.png)
+
+![image](uploads/6983c6cf0569da862e2b867f33761d49/image.png)
+
+Otherwise, open a terminal from the top navigation menu.
+
+![image](uploads/c4b9abce520ab42ded35bc7618cfb0b1/image.png)
+
+From this terminal, you can do anything as if you were using the terminal of the actual remote computer.
+
+![image](uploads/fbdefc33c3cd3f84b861d8ec544f575f/image.png)
\ No newline at end of file