"The WebSocket handshake failed" when using the cPanel Terminal

In the event that you receive an error message stating "Error: The WebSocket handshake failed" when trying to use the Terminal feature in cPanel, in our experience this can happen in the event that you are accessing cPanel via a proxy sub-domain, such as https://cpanel.yourdomain.com


To fix this, we suggest trying the following links to access cPanel -> Terminal:

https://$ipaddress:2083
https://$domain.tld/cpanel
https://cpanel.$domain.tld

In the event that none of these help, try disconnecting from any proxies or VPNs that you may be using, and also trying with other web browsers.

  • 1 Users Found This Useful
Was this answer helpful?

Related Articles

Full list of features

Below is a full list of all the options that will be available within your cPanel account:...

What name servers should I use for my website?

The name servers vary depending on the server that your account is on. Please search your email...

My site is displaying errors, help!

Errors can appear on websites for a number of reasons. Usually, these issues are quick to...

My site is being slow, what should I do?

If your website is being slow, we suggest doing the following: – Try to access your domain...

How do I secure my site?

These are some of the things we recommend you do to help secure your website.   1) Keep...