Cursor Remote Server Install

Manually install Cursor Server for Remote SSH on Windows hosts when Cursor cannot download or copy the server automatically.

中文文档

When To Use

Use this helper when Cursor Remote SSH connects to a Windows host but fails during server installation with errors such as:

• Download failed
• cursor.blob.core.windows.net
• Failed to copy server from local client
• vscode-reh-win32-x64.tar.gz
• Couldn't install Cursor Server

Usage

1. Find the server hash in the Cursor Remote SSH log.

   It usually appears in a URL like:

   https://cursor.blob.core.windows.net/remote-releases/<hash>/vscode-reh-win32-x64.tar.gz
   

2. Confirm SSH can run PowerShell on the remote host.

   ssh -T dev powershell -NoLogo -NoProfile -NonInteractive -Command '$HOME'

3. Run the installer from your local Windows machine.

   powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\cursor-remote-server-install\scripts\install-cursor-server.ps1" -HostName dev -ServerHash <hash>

4. Reconnect with Cursor Remote SSH.

Options

-HostName <ssh-host>
-ServerHash <cursor-server-hash>
-Platform win32-x64
-IsForce

Use -IsForce only when reinstalling the same server hash after a partial or corrupted install.

What It Does

The script downloads the matching Cursor Server archive, copies it to the remote Windows host with scp, extracts it into the expected .cursor-server directory, and verifies that node.exe is available.

Successful Output

A successful run prints output similar to:

Remote node:
v...
Installed:
<remote path>

If Cursor still fails afterward, check the latest Remote SSH log. Cursor may have updated and requested a different server hash.

Links

• Repository: guoxiao0521/cursor-remote-server-install
• Chinese README: README.zh-CN.md
• Installer script: scripts/install-cursor-server.ps1
• Skill definition: SKILL.md
• Cursor Server downloads: cursor.blob.core.windows.net