Skip to main content

Debugging Connectivity Issues

Learn how to test and resolve connectivity issues affecting your Pantheon sites.

Connectivity Error Message

The following indicates that there was a networking error when attempting to connect:

Command:    open "" 2222
Error:  ssh_init: Host not found
Error:  Could not connect to server''
Debugging connectivity issues

Services such as MySQL and SFTP are running; however, the local client is unable to connect due to an idled container or DNS issues. Before further troubleshooting, wake the environment by loading the home page or via the following Terminus command:

terminus env:wake site.env

Replace site and env with your site name and the correct environment

Resolve DNS Issues

Some ISPs have issues resolving a hostname. Troubleshoot connection errors using the following dig command, replacing <xxx> with your site’s UUID:

dig<xxx> +short

If there is no IP provided in the output, the default DNS server used for the query (typically configured by your ISP) has failed to recognize the hostname. Run the query again with an alternate DNS server specified, such as one of Google’s Public DNS IP Addresses:

dig @ dig<xxx> +short

If an IP address is returned, configure your network settings to use Google Public DNS.

Port 2222 or Other Blocked Ports

Make sure the port number is not blocked by your internal firewall. For example, to test whether port 2222 is blocked visit

If you are not able to access port 2222, you can try our workaround.

Test Connection on the Command Line

We recommend using the command line when troubleshooting connection issues as GUIs can hide underlying errors. From the site Dashboard, copy the provided connection command for the desired service and run it in terminal.