Troubleshooting & Support

I Can’t Connect with SSH

By TermSquad · Last reviewed

Match the SSH error to the connection stage. A timeout points to a different problem from Permission denied.

Check the basics

  1. Select the correct computer and confirm it is active.
  2. Copy its current hostname from Settings → SSH access.
  3. Use agent or admin as the Linux user.
  4. Confirm that the key or password belongs to that user on that computer.

Try the connection from your own device:

ssh agent@YOUR_HOSTNAME

Replace the hostname. If your key uses a custom filename, add -i followed by its local private-key path.

Interpret common errors

ErrorNext check
Could not resolve hostnameCopy the hostname again and check local DNS/network access.
Connection timed outCheck power state, network restrictions, and whether SSH is reachable.
Connection refusedThe host may be starting or its SSH service may be unavailable.
Permission deniedCheck user, matching key, key registration, and current password.
Host identification has changedVerify whether the computer was rebuilt or replaced before changing trust records.

Do not disable host-key checking to dismiss an unexplained warning.

Collect useful diagnostics

Use ssh -v agent@YOUR_HOSTNAME to inspect the connection stage. Review and redact the output before sharing it: diagnostics can reveal usernames, paths, and host details.

If the web terminal works, mention that to support. Do not paste private keys or passwords into a ticket.

See Connect with SSH, SSH keys, and support.