advanced · Time varies

PiKVM remote computer console

Build an open-source keyboard-video-mouse-over-IP appliance for remotely controlling another computer.

View original project ↗

What you’re building

PiKVM is an open-source keyboard-video-mouse-over-IP system that captures a target computer’s HDMI output and emulates USB keyboard, mouse, and optional mass storage, allowing browser control even at BIOS level or when the target OS is broken. The documented DIY path supports Raspberry Pi Zero 2 W with appropriate HDMI-to-CSI or USB capture hardware and board-specific USB wiring. Raspberry Pi 5 is explicitly unsupported because it lacks the GPU video encoders PiKVM relies on. A completed Zero 2 W build can provide low-latency remote console, virtual media, and optional ATX power control after PiKVM OS is flashed and both default passwords are replaced. Match the image and cabling to the documented Zero 2 W design, keep the management interface on a trusted network, and test video plus input locally before depending on it for remote recovery.

Key steps

  1. Use the supported Raspberry Pi Zero 2 W design and its matching capture and USB wiring; do not substitute a Pi 5.
  2. With all power disconnected, attach the documented HDMI capture device and board-specific USB OTG/power arrangement.
  3. Flash the exact PiKVM OS image for that hardware platform to the microSD card and insert it.
  4. Connect the target’s HDMI output, USB emulation cable, and network before powering the PiKVM.
  5. Wait for first boot, discover the PiKVM IP address, and open its HTTPS web interface.
  6. Immediately change both the Web UI admin password and Linux root password, then test KVM input and video.
Sources

Original project and code

Original project pages, manufacturer documentation and repositories used while preparing this page. Last reviewed .

  1. Project by pikvmpikvm