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
- Select the correct computer and confirm it is active.
- Copy its current hostname from Settings → SSH access.
- Use agent or admin as the Linux user.
- 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
| Error | Next check |
|---|---|
| Could not resolve hostname | Copy the hostname again and check local DNS/network access. |
| Connection timed out | Check power state, network restrictions, and whether SSH is reachable. |
| Connection refused | The host may be starting or its SSH service may be unavailable. |
| Permission denied | Check user, matching key, key registration, and current password. |
| Host identification has changed | Verify 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.
