Docs

Troubleshooting

The most common issues with their cause and fix.

"sshfs.exe not found"

SSHFS-Win is not installed or not in the expected location. Fix: download and run the installer from

  • C:\Program Files\SSHFS-Win\bin\sshfs.exe
  • C:\Program Files (x86)\SSHFS-Win\bin\sshfs.exe

PATH is also searched.

"mount point in use"

The selected drive letter is still occupied by an old mount.

  1. Choose a different drive letter, or
  2. Settings → Clean up stale mounts, or
  3. Disconnect the old drive in Explorer, or
  4. Restart Windows.

Host shows as “mounted” although the drive letter belongs to something else

If a drive already exists at startup (e.g. E:) and a host in NeoSSHWinManager is configured for exactly that drive letter, the app assumes the host is mounted — even though E: actually belongs to something else (a USB stick, a local partition, another network drive). Because the host counts as “mounted”, you cannot edit it normally. Here is how to change the drive letter anyway:

  1. Enable Debug mode in Settings.
  2. In Debug mode the host can still be edited (Edit).
  3. In the edit dialog, pick a free drive letter and save.

Afterwards you can turn Debug mode off again.

"Authentication failed"

  • Check your password — edit the connection and re-enter it.
  • For SSH key: is the path correct? Does the key have a passphrase?
  • On the server: is your public key in ~/.ssh/authorized_keys?
  • Server config: is PasswordAuthentication / PubkeyAuthentication enabled in sshd_config?

"Connection refused"

The SSH service is not running or a firewall is blocking the connection. Test:

ssh -p <port> <user>@<host>

From PowerShell. If this also fails, it is not an app issue.

Drive appears but "Access denied"

Reinstall SSHFS-Win and verify that the WinFsp service is running (Services → WinFsp).

-oidmap=user -ouid=-1 -ogid=-1
-oumask=000 -ocreate_umask=000
-odefault_permissions

If the issue persists: reinstall SSHFS-Win and verify that the WinFsp service is running (services.msc).

App doesn’t start or doesn’t come to the foreground

Another instance is already running. Check the system tray — the app may be minimised. If not, end it in Task Manager and restart.

  • Check the tray — the app may be minimised.
  • Find NeoSSHWinManager.exe in Task Manager and end it.

View logs

Enable Debug mode in Settings. Logs are saved to %APPDATA%\SSHWinManager\app.log.