Cursor SSH:Quick Reference

Quick Setup Checklist

On Your Local Machine (where Cursor runs):

Create SSH config (`~/.ssh/config`):

   Host raspberrypi
       HostName 87.106.61.62
       Port 22223
       User root
       IdentityFile ~/.ssh/id_rsa

Generate and copy SSH key:

   ssh-keygen -t ed25519 -C "cursor-raspberrypi"
   ssh-copy-id -p 22223 root@87.106.61.62

Test connection:

   ssh -p 22223 root@87.106.61.62

In Cursor:

   Install "Remote - SSH" extension
   Press F1 → Remote-SSH: Connect to Host...
   Select raspberrypi

On VPS (Already Done ✅):

✅ Port forward configured: 22223 → 10.8.0.3:22 ⚠️ Action Required: Add port 22223 to IONOS firewall

On Raspberry Pi:

✅ SSH server enabled ✅ Root SSH access enabled (see main guide) ✅ Connected to VPN (10.8.0.3) ⚠️ Action Required: Add your SSH public key to /root/.ssh/authorized_keys

Connection String

ssh -p 22223 root@87.106.61.62

Cursor Connection

Host: raspberrypi (from SSH config)

Or direct: root@87.106.61.62:22223

Troubleshooting

Issue	Solution
Connection timeout	Check IONOS firewall for port 22223
Permission denied	Copy SSH key: `ssh-copy-id -p 22223 root@87.106.61.62`
Cursor server fails	Clear cache: `rm -rf ~/.cursor-server` on Pi

Full Documentation

See: [Cursor SSH Setup Guide](cursor-ssh-setup.md)