Back to website
JetKVM for GitHub ActionsDocs

Getting Started

Troubleshooting

Loading Video Stream Issue

The most common issue with JetKVM is getting stuck at "Loading video stream..." when trying to connect to your device. This problem is typically caused by WebRTC connection issues between your browser and the JetKVM device.

1. Update JetKVM Firmware

  • Navigate to the IP address displayed on your JetKVM device
  • Go to Settings → Check for Updates
  • If an update is available, apply it and check if the issue is resolved

2. Verify WebRTC Functionality

  • Temporarily disable all browser extensions that might block or alter WebRTC connections
  • If using a VPN or corporate network, try temporarily disconnecting as these can block WebRTC traffic

3. Browser-Specific Settings

For Chromium:

  • Navigate to chrome://flags/#webrtc-ip-handling-policy in your address bar
  • Look for "WebRTC IP Policy"
  • If it's set to "Disable non proxied UDP", change it to "Default"
  • Restart your browser for the changes to take effect

For Microsoft Edge:

  • In your address bar, enter edge://settings/content/mediaAutoplay
  • Ensure your JetKVM URL is in the Allow list, as Edge may block autoplay by default

For Vivaldi:

  • Navigate to vivaldi://flags/#ignore-gpu-blocklist
  • Enable "Override software rendering list" (ignore the GPU blocklist)
  • Go to Vivaldi Settings → Webpages and ensure "Use hardware acceleration when available" is enabled
  • Make sure "Broadcast IP for best WebRTC Performance" is enabled
  • Restart the browser after making these changes

For Firefox:

  • Navigate to about:config
  • Search for media.peerconnection.enabled
  • Set it to true
  • Restart the browser after making these changes

4. Check Browser Autoplay Settings

  • As noted by some users, browsers may block video autoplay by default
  • Ensure autoplay settings for video/audio are enabled for the JetKVM site

Still Having Issues?

If none of the above steps resolve your issue:

  1. Visit our GitHub issue #84 where we're actively monitoring this problem

  2. When reporting your issue, please include:

    • The data shown at the bottom of the video feed when Troubleshooting Mode is enabled (Settings > Advanced > Enable Troubleshooting Mode)
    • Your network configuration (router type, network setup)
    • The devices/computers you've tried connecting to
    • Any browsers you've tested with and their results
    • The JetKVM app version and system version

Our team is actively working to resolve these connection issues with each firmware update.