Troubleshoot network problems

Troubleshoot OpenShift Dev Spaces network connectivity issues including WebSocket failures, proxy configuration problems, and Domain Name System (DNS) resolution errors.

Before you begin

  • You have an active workspace URL or the OpenShift Dev Spaces dashboard URL.

Procedure

  1. Verify that the browser supports WebSocket connections by opening the browser developer tools (F12), navigating to the Console tab, and running: 
    var ws = new WebSocket('wss://echo.websocket.org');
ws.onopen = function() { console.log('WebSocket OK'); ws.close(); };
ws.onerror = function() { console.log('WebSocket FAILED'); };

    If the output is WebSocket FAILED, WebSocket connections are blocked. Contact your network administrator to allow WSS connections on port 443.

  2. Verify that firewall rules allow WebSocket Secure (WSS) connections on port 443 to the OpenShift Dev Spaces hostname.
  3. If your network uses a proxy server, verify that the proxy allows WebSocket upgrade requests. Some proxies block HTTP upgrade headers by default.
  4. Verify DNS resolution from a workspace terminal: 
    nslookup <devspaces_hostname>

    If the DNS lookup fails, the workspace Pod cannot resolve the OpenShift Dev Spaces hostname. Verify the cluster DNS configuration and any custom DNS settings in the workspace namespace.

  5. If you encounter x509: certificate signed by unknown authority errors when connecting to an HTTPS endpoint from inside a workspace, the workspace does not trust the TLS certificate.

    Contact your administrator to import the required Certificate Authority (CA) certificates.

Results

  • Open a workspace and verify that the IDE loads without connection errors.
  • Verify that Git operations (clone, push, pull) complete without network timeouts.