Fix SSH Could Not Resolve Hostname in 4 Quick Steps

ssh could not resolve hostname

SSH stands for secure shell, and it is a security protocol that provides end-to-end encryption of data. SSH could not resolve hostname is an error message that occurs when the host system fails to resolve the IP address of the remote host provided with the ssh command. Ssh protocol is widely used to provide secure remote shell access.

The ssh command is used to connect to a remote host. The ssh command requires a hostname to connect to, which is then inquired from a DNS(Domain Name System) server that sends the IP address of the remote host the user is trying to login to. If, for some reason, if the hostname is not resolved, then the ssh could not resolve the hostname error message is displayed.


Understanding SSH

Secure Shell is an intermediate protocol that is implemented between the application layer and the transport layer of the Internet protocol stack. It works on top of the TCP protocol, ensuring reliable delivery and data integrity. To connect to a remote shell, use the ssh command and provide the username and the hostname of the remote host you are trying to connect. Public key cryptography is used to authenticate the user. The private key is stored in the user’s host, which provides authentication. The ssh could not resolve hostname is one of the common errors faced while using ssh.

ssh command running on Arch machine
ssh command running on Arch machine

SSH hostname resolution and DNS

The hostname provided in the ssh command has to be resolved to an IP address, i.e., the address of the remote host in computer-readable form. The hostname can be provided in the IP address form example,, or a name can be used instead of, for example. A DNS server is used to resolve the hostname to an IP address. The string of characters provided as the hostname in the command is sent to the DNS server, which then, in turn, returns the IP address of the host.

If the host is unable to contact the DNS server or the DNS server doesn’t return a valid IP address in return then, ssh could not resolve the hostname error that occurs. The ssh could not resolve hostname can also happen due to the cached DNS data stored in the system. Frequently used Domain name addresses are stored in cache storage in the host system so that the system doesn’t need to enquire the DNS server every time it makes a request. If the cache data is outdated or the host’s IP has been charged, the cached data becomes useless and can cause problems like ssh could not resolve the hostname.

Fixes ssh could not resolve hostname

If you are receiving the ssh could not resolve the hostname error, then a few steps can be employed to resolve and avoid this error message. Consider the given steps to fix the ssh could not resolve the hostname error.

Check the hostname

Most of the basic and simple measures to avoid the ssh could not resolve hostname is to check whether the hostname you are using with the ssh command is correct or not. Using the wrong hostname or domain address might result in a Wrong DNS response or no valid response at all. Check your hostname address for typos and syntax errors of the command. If everything is correct but still getting the hostname does not resolve the error, then employ the following measures.

Clearing DNS Cache

Clearing the DNS cache might also help resolve the ssh could not fix the hostname error. After the DNS cached data is deleted, a new fresh DNS inquiry is sent to the DNS server for each request, which would be beneficial if the IP address of the host is changed. Follow the given steps to clear the DNS cache in Windows.

  • Press Windows + R.
  • Enter cmd in the serach box and hit enter.
  • In the shell Enter the command ipconfig /flushdns.
  • The DNS cache is not cleared.
  • Try running the ssh command again.

For Ubuntu users, Enter the following command in the terminal to clear the DNS cache manually.

sudo clean restart

Editing the /etc/hosts file

If you are trying to connect to a remote host using ssh for the first time and getting a hostname error not resolved error in return, try editing the ssh hosts file and entering the username and hostname in the file. Employing the given steps to edit the hosts’ file and fix the ssh could not resolve the hostname error.

  • Open the terminal emulator.
  • Enter sudo nano /etc/hosts.
  • Enter your root password.
  • Now in the file, enter the IP address and hostname of your remote host.
  • Press ctrl + O to save the file.
  • Press ctrl + X to exit nano.
  • Run the ssh command again.

SSh could not resolve hostname

ssh could not resolve hostname

The ssh could not resolve hostname error can also show up while using the git version management program. The git uses the ssh while cloning a repository or pushing a remote repository. The issue can be fixed with the following steps.

  • Try to ping the using the ping command. If the server responds then try to run the git command again after rebooting the system, it might be a normal network issue.
  • If the issue persists, follow the steps mentioned above, such as clearing the DNS cache.
  • Run the following command to restart the network manager in linux, which might help resolve the issue.
sudo service network-manager restart

SSH could not resolve hostname Gitlab

Gitlab is another popular open-source platform that is widely used in DevOps operations. “ssh: Could not resolve hostname¬† Temporary failure in name resolution” is the error message that is displayed while logging into the GitLab server. As the message itself suggests, this is a temporary failure in the name resolution, and chances would be resolved automatically after some time. But if the problem persists, follow the steps suggested above to make it work. You could also try adding ssh:// before the git URL to resolve the hostname issue.

git clone ssh://[email protected]:username/This_is_a_demo.git

SSH could not resolve hostname

Bitbucket is another open platform used to host git repositories online. The same hostname resolution problem can be encountered with as with To resolve this issue, use the suggested methods and configure your .git config file. Open the config file in the .git folder for your project’s main directory. Change the remote directory listing as mentioned below (remove the ssh:// in the config file) and rerun the command.

url = ssh://[email protected] 

url = [email protected]

FAQs on SSH Could Not Resolve Hostname

What is TCP?

It stands for Transfer Control Protocol. It is a transport layer protocol that ensures the reliable hosts-to-host delivery of the data packets.

What is the difference between git and GitHub?

Git is a version management program that keeps track of the changes in a project, While GitHub is an online platform where people can share their git repositories.

What is the Linux equivalent of ipconfig?

The Linux equivalent of the ipconfig command is ifconfig.


The ssh could not resolve hostname is a common error that any user can face. It is not that big of an issue. It simply happens when the ssh command fails to resolve the IP address of the provided hostname. In such situations clearing the DNS cache or editing the /etc/host file can help. This article provided you with the necessary measure and solutions to fix this error. In the end, we also mentioned what to do if you are receiving this error while using the git CLI.

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top