Editing Cursor SSH:Setup (section)

=== 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>