Topic

SSH troubleshooting

SSH troubleshooting guides from Tryssh: practical diagnostics, safe operating procedures, and production runbooks for server operators.

SSH platform diagnostics for 25 environments

Compare SSH diagnostic boundaries, recovery paths, read-only checks, and first-party documentation across Linux, cloud, CI, macOS, Windows, and bastions.

The Tryssh team · July 28, 2026 →

SSH banner timeout

TCP connects, but the server does not send its SSH identification before the client or server grace period expires.

The Tryssh team · July 22, 2026 →

SSH Match and Include order

The effective option comes from an unexpected Host, Match, or Include block because OpenSSH generally keeps the first obtained value.

The Tryssh team · July 22, 2026 →

SSH exit code 255

SSH reports its generic fatal-error code, while the useful cause appears earlier in stderr or verbose output.

The Tryssh team · July 22, 2026 →

Lost SSH private key recovery

The private key is missing or unreadable; because private keys cannot be reconstructed from public keys, access must be recovered through another trusted path.

The Tryssh team · July 22, 2026 →

SSH permission denied (publickey)

The network connection succeeds, but the server rejects every public key the client offers.

The Tryssh team · July 22, 2026 →

SSH port forwarding not working

SSH authenticates, but the local, remote, or dynamic forwarding endpoint cannot carry the expected application traffic.

The Tryssh team · July 22, 2026 →

SSH ProxyJump not working

The client cannot complete one of the distinct hops from local machine to bastion to target.

The Tryssh team · July 22, 2026 →

SCP legacy protocol compatibility

Modern scp uses SFTP by default, but an older server or unusual shell expects legacy SCP behavior and fails differently.

The Tryssh team · July 22, 2026 →

SSH user certificate expired

Public-key authentication uses a signed user certificate whose valid-before time has passed or whose client and server clocks disagree.

The Tryssh team · July 22, 2026 →

SSH X11 forwarding not working

The SSH session works but remote X applications cannot connect to the locally forwarded display.

The Tryssh team · July 22, 2026 →