mirror of
https://github.com/jetkvm/website.git
synced 2025-09-16 08:38:16 +00:00
69 lines
2.7 KiB
Plaintext
69 lines
2.7 KiB
Plaintext
---
|
|
title: "Troubleshooting"
|
|
description: "Troubleshoot common JetKVM issues with a focus on resolving the Loading Video Stream problem and ensuring proper WebRTC connections."
|
|
order: 1
|
|
---
|
|
|
|
## 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](https://github.com/jetkvm/kvm/issues/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.
|