ponshu-room-lite/docs/architecture/VSCODE_SSH_SETUP_GUIDE.md

41 lines
1.6 KiB
Markdown

# VS Code Remote SSH Setup Guide
<!--
Use this guide to connect your Company PC to the "Digital Fortress" (Synology Ubuntu VM).
-->
## 1. Install the Extension
1. Open VS Code on your local PC.
2. Go to the **Extensions** view (Square icon on the left).
3. Search for **"Remote - SSH"** (by Microsoft).
4. Click **Install**.
## 2. Configure the Connection
1. Press `F1` (or `Ctrl+Shift+P`) to open the Command Palette.
2. Type **"Remote-SSH: Open SSH Configuration File"**.
3. Select the first option (usually `C:\Users\...\.ssh\config`).
4. Add the following entry (replace with actual values):
```ssh
Host posimai-fortress
HostName 100.x.y.z # Tailscale IP of the Ubuntu VM
User ubuntu # Username on the VM
# IdentityFile ~/.ssh/id_rsa # Path to your private key (if used)
```
*Tip: Using the Tailscale IP (`100.x...`) is recommended as it works from anywhere (home or office).*
## 3. Connect!
1. Click the green **"><"** icon at the very bottom-left corner of VS Code.
2. Select **"Connect to Host..."**.
3. Select **`posimai-fortress`**.
4. A new VS Code window will open. It might ask for a password (if you haven't set up keys).
5. Once connected, click **"Open Folder"** and navigate to `/home/ubuntu/dev/posimai/`.
## 4. Verify
* Open the Terminal in VS Code (`Ctrl+J`).
* Type `hostname`. It should say `ubuntu` (or whatever you named the VM), NOT your local PC name.
* **Success!** You are now inside the Fortress. All code stays there.
---
**Next Step**:
Once connected, open a **New Cursor Chat** and paste the `CURSOR_CHAT_MASTER_CONTEXT.md` prompt.