VS Code Remote SSH Could Not Establish Connection

How to fix it

Try these in order — the most common fix is first.

1. 1. Test SSH outside VS Code

   Copy steps
   1. Run ssh -v user@host in a terminal
   2. Fix key, host or port problems shown there
   Did this fix it? Yes No

2. 2. Read the Remote-SSH log

   Copy steps
   1. Open the Output panel and select Remote - SSH
   2. Find the first failing line
   Did this fix it? Yes No

3. 3. Reinstall the server on the remote

   Copy steps
   1. SSH in manually and delete the ~/.vscode-server folder
   2. Reconnect so VS Code reinstalls it
   Did this fix it? Yes No

4. 4. Toggle remote.SSH.useLocalServer

   Copy steps
   1. Try true and false; reports differ by environment
   2. One report also set remote.SSH.useExecServer to true
   Did this fix it? Yes No

5. 5. Use full key paths

   Copy steps
   1. Set IdentityFile in ~/.ssh/config to a full path
   2. On Windows use the system OpenSSH client, not PuTTY
   Did this fix it? Yes No

Symptoms

Remote - SSH shows 'Could not establish connection to host' or a resolver error.

Why it happens

• SSH itself failing (keys, host, firewall)
• VS Code server version mismatch after an update
• Wrong IdentityFile path
• Windows without the system OpenSSH client
• Local server setting incompatible with your environment

This guide also covers

• vscode remote ssh could not establish connection
• vscode remote ssh resolver error

The same problem in other apps

All not loading, error messages & connection guides →

• Cursor High Load Error (ERROR_RESOURCE_EXHAUSTED) (Cursor)

Other VS Code errors

• VS Code Terminal Not Working
• VS Code Python Interpreter Not Found
• VS Code IntelliSense Not Working
• VS Code High CPU Usage
• VS Code High Memory Usage
• VS Code Extension Host Terminated Unexpectedly
• VS Code Extensions Not Loading or Installing
• VS Code 'code' Command Not Found