Editing Cursor SSH:Setup (section)

== '''Select Platform''' (if prompted): ==
   * Choose: <code>Linux</code> → <code>arm64</code> or <code>armv7l</code> (depending on your Pi model)

=== 5. Troubleshooting Connection Issues ===

==== Issue: Connection Timeout ====

'''Check IONOS Firewall:'''
* Verify port <code>22223</code> is allowed in IONOS Cloud Panel

* Check rule priority (lower numbers = higher priority)

'''Test SSH connection manually:'''
<pre class="lang-bash">
ssh -v -p 22223 root@87.106.61.62
</pre>

'''Check port forward on VPS:'''
<pre class="lang-bash">
== On VPS ==
sudo ssh-forward list
iptables -t nat -L PREROUTING -n | grep 22223
</pre>

==== Issue: "Permission Denied" ====

'''Verify SSH key is authorized:'''
<pre class="lang-bash">
===== On Raspberry Pi =====
cat ~/.ssh/authorized_keys
== Should contain your public key ==
</pre>

'''Check SSH server logs:'''
<pre class="lang-bash">
== On Raspberry Pi ==
sudo tail -f /var/log/auth.log
== Attempt connection and watch for errors ==
</pre>

'''Verify user permissions:'''
<pre class="lang-bash">
== On Raspberry Pi ==
ls -la ~/.ssh/
== Should be: drwx------ (700) for .ssh directory ==
== Should be: -rw------- (600) for authorized_keys ==
</pre>

==== Issue: Cursor Server Installation Fails ====

'''Clear Cursor server cache:'''
<pre class="lang-bash">
===== On Raspberry Pi =====
rm -rf ~/.cursor-server
</pre>

'''Check disk space:'''
<pre class="lang-bash">
== On Raspberry Pi ==
df -h
</pre>

'''Check Python/Node.js availability:'''
<pre class="lang-bash">
== On Raspberry Pi ==
python3 --version
node --version  # If available
</pre>

==== Issue: Slow Connection ====

'''Optimize SSH config:'''
Add to <code>~/.ssh/config</code>:
<pre>
Host raspberrypi
    Compression yes
    IPQoS throughput
</pre>

'''Use SSH multiplexing:'''
<pre>
Host raspberrypi
    ControlMaster auto
    ControlPath ~/.ssh/control-%h-%p-%r
    ControlPersist 10m
</pre>

=== 6. Verify Complete Setup ===

'''Test checklist:'''

* [ ] SSH port forward is active: <code>sudo ssh-forward list</code>

* [ ] IONOS firewall allows port 22223

* [ ] Can SSH manually: <code>ssh -p 22223 root@87.106.61.62</code>

* [ ] SSH key authentication works (no password prompt)

* [ ] Cursor can connect via Remote SSH

* [ ] Cursor server installed on Raspberry Pi

* [ ] Can open files and use terminal in Cursor

=== 7. Multiple Devices Configuration ===

If you have multiple devices, add separate entries in <code>~/.ssh/config</code>:

<pre>
Host synology
    HostName 87.106.61.62
    Port 22222
    User admin
    IdentityFile ~/.ssh/id_rsa

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

Host device-03
    HostName 87.106.61.62
    Port 22223
    User user
    IdentityFile ~/.ssh/id_rsa
</pre>