SSH Issue: Diagnostics & Troubleshooting

How to securely log in to your server

While managing a Linux server, you might encounter a common problem: not being able to connect to your server via SSH ( Secure Shell). SSH allows secure remote login from one computer to another. It provides strong password authentication and encrypted data communications between two computers connecting over an open network such as the internet. SSH is widely used by network administrators for managing systems and applications remotely.

Why SSH Issues Occur

SSH issues can occur due to a variety of reasons. Some common causes include:

  • The SSH service is not running on your server.
  • Network connection issues.
  • Incorrect SSH configuration settings in the /etc/ssh/sshd_config file.
  • Firewall rules blocking the SSH port (default is 22).
  • Issues with SSH keys, such as wrong permissions or wrong owner.

Diagnosing SSH Issues

Diagnosing SSH issues involves checking the status of the SSH service, verifying network connectivity, examining the SSH configuration settings, inspecting firewall rules, and validating SSH keys.

Checking SSH Service Status

On your server, you can use the systemctl command to check the status of the SSH service. Here's how:

sudo systemctl status ssh

This command will show whether the SSH service is active or inactive.

Verifying Network Connectivity

You can verify network connectivity using the ping command:

ping <your-server-ip-address>

If the server is reachable, you will see the ping statistics. If not, it implies network issues.

Examining SSH Configuration

The SSH configuration file is located at /etc/ssh/sshd_config. You can inspect this file using any text editor:

sudo nano /etc/ssh/sshd_config

Ensure that the settings are correct, especially the SSH port.

Inspecting Firewall Rules

To check if the firewall is blocking the SSH port, use the ufw command:

sudo ufw status

Ensure that the SSH port (default 22) is allowed.

Validating SSH Keys

SSH keys should have the correct permissions. The private key (~/.ssh/id_rsa) should be readable and writable only by the owner. You can check the permissions using the ls command:

ls -l ~/.ssh/id_rsa

Troubleshooting SSH Issues

Depending on the cause, there are several ways to troubleshoot SSH issues.

Starting the SSH Service

If the SSH service is not running, start it using systemctl :

sudo systemctl start ssh

Fixing Network Issues

If there's a network issue, you may need to contact your Internet Service Provider or check your local network settings.

Correcting SSH Configuration

If there are incorrect settings in the SSH configuration file, correct them and restart the SSH service:

sudo systemctl restart ssh

Adjusting Firewall Rules

If the firewall is blocking the SSH port, adjust the rules to allow it:

sudo ufw allow 22

Fixing SSH Keys

If there are issues with SSH keys, you may need to generate a new pair:

ssh-keygen -t rsa


Dealing with SSH issues can be challenging, especially for Linux beginners. However, with a systematic approach to diagnosing and troubleshooting, you can quickly resolve these issues and ensure a secure and efficient connection to your server. Remember, the key to effective troubleshooting is understanding the problem and knowing where to look.

Except where otherwise noted, content on this site is licensed under a CC BY-SA 4.0 license CC BY SA