Error: The WebSocket handshake failed.

[Ernesto Dionisio]

System installed:
CENTOS
WHM/cPanel
Cloudflare

Home / Server Configuration / Terminal

Error: The WebSocket handshake failed.

this error occurred, what am I missing when I tried searching for solution it has cagefs in which I don't have it yet. Can somebody help?

 

[Spirogg]

System installed:
CENTOS
WHM/cPanel
Cloudflare

Home / Server Configuration / Terminal

Error: The WebSocket handshake failed.

this error occurred, what am I missing when I tried searching for solution it has cagefs in which I don't have it yet. Can somebody help?

In the event that you receive an error message stating Error: The WebSocket handshake failed when trying to use the Terminal feature in cPanel or WHM, in our experience this can happen if you are accessing cPanel / WHM via a proxy sub-domain, such as or https;//hostaname.yourdomain.com or 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

If none of those links work, try disconnecting from any proxies or VPNs that you may be using, and also trying with other web browsers.

Also for WHM terminal
https://$ipaddress:2087
make sure you are using https://hostname.yourdomain.tld:2087
or https://youripaddress:2087

https://xxx.xxx.xxx.xx:2087

if for some reason you don't have a SSL Certificate for your hostname you might get this error so try and use your IP address
https://xxx.xxx.xxx.xx:2087 then login to your whm and try the terminal

if you are using a VPN you might get this error also, so try not using the VPN or try another web browser.

 

[cPRex]

Thanks, @Spirogg !!!

 

[Ernesto Dionisio]

I did https://$ipaddress/whm and it works... but I dont want it to work that way I want it to work like https://hostname.yourdomain.tld:2087 or https://hostname.yourdomain.tld/whm this is in the setup, but when I go to terminal that is my issue dont know why?

I also want my IP to be masked like https://hostname.yourdomain.tld as I add it at the zone as "A" "@" and "cname" "server" when I type the IP it gives me my hostname. I thought it was configure thru dns zone.

 

[Spirogg]

I want it to work like https://hostname.yourdomain.tld:2087

do you have your hostname setup in WHM.
'

did you add your hostname here

• Home /Networking Setup /Change Hostname

and then you added your IP as A record for this hostname?

 

[Spirogg]

I want it to work like https://hostname.yourdomain.tld:2087 or https://hostname.yourdomain.tld/whm this is in the setup, but when I go to terminal that is my issue dont know why?

do you have SSL Certificate for your hostname ?
when you go to https://hostname.yourdomain.com:2087
do you see secure site in your browser or does it say not secure?"

 

[Spirogg]

Do you add your A record here for hostname in WHM ?

Add an A Entry for Your Hostname

• Home /DNS Functions /Add an A Entry for Your Hostname

Hostname	Server Main IP
hostname.yourdomain.com	xx.xx.xxx.xx

Please confirm the IP address to use for the "A Entry" for hostname.yourdomain.com

 

[Spirogg]

I did https://$ipaddress/whm and it works... but I dont want it to work that way I want it to work like https://hostname.yourdomain.tld:2087 or https://hostname.yourdomain.tld/whm this is in the setup, but when I go to terminal that is my issue dont know why?

I also want my IP to be masked like https://hostname.yourdomain.tld as I add it at the zone as "A" "@" and "cname" "server" when I type the IP it gives me my hostname. I thought it was configure thru dns zone.

do you Cloudflare for your server and hostname ?

I believe if you have domain.com added in Cloudflare? you'd need to create the A record for hostname.yourdomain.com in Cloudflare's interface.

 

[Ernesto Dionisio]

do you have your hostname setup in WHM.
'

did you add your hostname here

• Home /Networking Setup /Change Hostname

and then you added your IP as A record for this hostname?

 

[Ernesto Dionisio]

Do you add your A record here for hostname in WHM ?

Add an A Entry for Your Hostname

• Home /DNS Functions /Add an A Entry for Your Hostname

Hostname	Server Main IP
hostname.yourdomain.com	xx.xx.xxx.xx

Please confirm the IP address to use for the "A Entry" for hostname.yourdomain.com

 

[Ernesto Dionisio]

yes I use cloudflare, for the domain and I add a cname named "server". I can browse it like https://server.domain.tld:2087

do you Cloudflare for your server and hostname ?

I believe if you have domain.com added in Cloudflare? you'd need to create the A record for hostname.yourdomain.com in Cloudflare's interface.

 

[Spirogg]

yes I use cloudflare, for the domain and I add a cname named "server". I can browse it like https://server.domain.tld:2087

do you have SSL certificate for your server.yourdomian.com
so when you log in at server.yourdomain.com:2087 is this secure login (SSL)

 

[Ernesto Dionisio]

yes it is used to be a default in cloudflare *.domain.tld, domain.tld
type: Universal
Status: Active
Expires on: 2023-04-05

 

[Spirogg]

yes it is used to be a default in cloudflare *.domain.tld, domain.tld
type: Universal
Status: Active
Expires on: 2023-04-05

I’m
Not sure then maybe @cPRex has an idea if cloudflare would cause this issue ??

 

[cPRex]

@Ernesto Dionisio - I'm not entirely sure what the issue is at this point. Were you able to get the hostname pointed to the server so you can access WHM with it?

 

[amma]

System installed:
CENTOS
WHM/cPanel
Cloudflare

Home / Server Configuration / Terminal

Error: The WebSocket handshake failed.

this error occurred, what am I missing when I tried searching for solution it has cagefs in which I don't have it yet. Can somebody help?

 

[cPRex]

@amma - it sounds like this is the Terminal in WHM as the root user. The CageFS solution you found would apply to individual cPanel users.

Can you see if this is the issue on your machine? https://support.cpanel.net/hc/en-us/articles/1500000736341