Beacon KVM

Appearance

Troubleshooting ​

Device not showing up in console ​

  • Make sure the Pi is connected to the internet
  • Check the service is running: sudo systemctl status beacon-kvm
  • Check logs: sudo journalctl -u beacon-kvm -f

No video feed ​

  • Check the HDMI capture card is plugged into the Pi
  • Make sure the target machine's HDMI output is active
  • Try a different USB port on the Pi
  • Run ls /dev/video* — if nothing shows, the capture card may not be recognized

Keyboard and mouse not working ​

  • Make sure the USB-C cable is connected from the Pi's USB-C port to the target machine
  • The USB-C port must support USB data (not power-only cables)
  • Check the dwc2 overlay is enabled: grep dwc2 /boot/firmware/config.txt
  • Reboot the Pi after first install: sudo reboot

Remote access is slow or unstable ​

Remote access quality depends on your network and hardware. For guaranteed performance, consider upgrading to a Remote Access plan.

Reinstalling ​

To remove Beacon KVM:

bash
curl -fsSL https://get.beacon-kvm.com/uninstall.sh | sudo bash

To reinstall, run the install script again:

bash
curl -fsSL https://get.beacon-kvm.com | sudo bash