JetKVM - Control any computer remotely
kvm
  • TypeScript 35.8%
  • C 35.6%
  • Go 26%
  • Shell 0.9%
  • Makefile 0.5%
  • Other 1%
Find a file
Adam Shiervani 49f30d9dde
Some checks failed
build / Build and test (push) Has been cancelled
lint / Go (push) Has been cancelled
lint / UI (push) Has been cancelled
test(e2e): add S3 suspend/wake tests via USB remote wakeup (#1392)
Add two e2e tests that verify JetKVM can wake a host from S3 sleep
using HID input (keyboard and mouse). Tests trigger suspend via
`echo mem > /sys/power/state`, wait for the host to become
unreachable, then send HID reports and verify recovery.

Both tests skip gracefully when system firmware is below 0.2.8
(missing wakeup_on_write kernel support) or when the remote host
doesn't support S3 deep sleep.

Also adds a `semverGte` helper for version comparisons.
2026-04-02 15:01:14 +02:00
.devcontainer fix(devcontainer): make install-deps work on arm64/aarch64 (#1217) 2026-03-05 10:53:14 +01:00
.github ci: redesign workflows into lint + build (#1330) 2026-03-25 18:44:34 +01:00
.vscode Update dependencies and improve code formatting (#1072) 2025-12-15 16:00:08 +01:00
bin Release 202412292127 2024-12-29 21:27:42 +01:00
cmd refactor(cmd): replace fmt.Printf with zerolog in supervisor (#1302) 2026-03-17 09:35:59 +01:00
e2e/remote-agent fix: send mouse button state changes via reliable WebRTC channel (#695) (#1338) 2026-03-28 23:14:02 +01:00
internal fix(mouse): prevent double wheel scroll by sending to only one HID device (#1390) 2026-04-01 10:58:58 +02:00
pkg Refactor logging levels and enhance debug messages across multiple components (#1142) 2026-01-08 21:39:57 +01:00
resource feat: jetkvm native in cGo 2025-09-29 14:09:30 +02:00
scripts feat(build): add podman support for dev deploy scripts (#1303) 2026-03-24 18:59:02 +01:00
ui test(e2e): add S3 suspend/wake tests via USB remote wakeup (#1392) 2026-04-02 15:01:14 +02:00
.gitignore Signed Releases (#1188) 2026-03-05 18:26:23 +01:00
.golangci.yml feat: add command to show version (#604) 2025-07-11 11:32:46 +02:00
block_device.go chore/Deprecate browser mount (#752) 2025-08-28 23:46:55 +02:00
block_device_linux.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
block_device_notlinux.go network enhanecment / refactor (#361) 2025-04-16 01:39:23 +02:00
cdc_acm_console.go feat: add USB CDC-ACM serial console gadget (#726) (#1352) 2026-03-27 23:09:39 +01:00
cloud.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
CODE_OF_CONDUCT.md Release 202412292127 2024-12-29 21:27:42 +01:00
config.go feat(video): add H.265 codec support with auto-negotiation (#1371) 2026-03-29 21:34:38 +02:00
dc_metrics.go feat(metrics): adding prometheus metrics for dc power extension (#556) 2025-07-11 17:04:41 +02:00
dev_deploy.sh feat: jetkvm native in cGo 2025-09-29 14:09:30 +02:00
DEVELOPMENT.md feat(remote): add support for custom tailscale control servers (#1312) 2026-03-24 15:20:15 +01:00
display.go Enhance synctrace logging (#980) 2026-01-28 09:19:56 +01:00
Dockerfile.build feat: jetkvm native in cGo 2025-09-29 14:09:30 +02:00
failsafe.go Enhance synctrace logging (#980) 2026-01-28 09:19:56 +01:00
go.mod MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
go.sum MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
hidrpc.go fix: remove goroutine from HID message handler to prevent leak and disconnect race (#1336) 2026-03-28 22:11:52 +01:00
hw.go Enhance synctrace logging (#980) 2026-01-28 09:19:56 +01:00
jiggler.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
jsonrpc.go feat(video): add H.265 codec support with auto-negotiation (#1371) 2026-03-29 21:34:38 +02:00
LICENSE Release 202412292127 2024-12-29 21:27:42 +01:00
log.go feat: add USB CDC-ACM serial console gadget (#726) (#1352) 2026-03-27 23:09:39 +01:00
main.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
Makefile Bump version to 0.5.6 2026-03-31 11:25:38 +02:00
mdns.go feat: refactoring network stack (#878) 2025-10-15 18:32:58 +02:00
mqtt.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
mqtt_commands.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
mqtt_discovery.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
mqtt_publish.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
native.go feat: add factory reset to replace config-only reset (#529) (#1355) 2026-03-27 15:52:52 +01:00
network.go feat(network): add custom NTP/HTTP time sync configuration UI (#1289) 2026-03-29 12:16:52 +02:00
ota.go feat: add factory reset to replace config-only reset (#529) (#1355) 2026-03-27 15:52:52 +01:00
prometheus.go chore: Enable more linters 2025-03-26 18:41:09 +01:00
publish_source.sh fix: Shell linting (#328) 2025-04-11 00:43:45 +02:00
ratelimit.go Rate limit login access (#1185) 2026-02-08 10:19:28 +01:00
README.md feat(remote): add support for custom tailscale control servers (#1312) 2026-03-24 15:20:15 +01:00
serial.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
serial_console_helpers.go Feature: Add custom serial buttons extension (#821) 2026-03-05 11:34:51 +01:00
tailscale.go refactor: move tailscale logic into internal/tailscale package (#1318) 2026-03-24 15:41:44 +01:00
terminal.go fix: Log spam when using a web terminal #547 (#550) 2025-06-03 01:51:30 +02:00
timesync.go feat: refactoring network stack (#878) 2025-10-15 18:32:58 +02:00
usb.go fix(mouse): prevent double wheel scroll by sending to only one HID device (#1390) 2026-04-01 10:58:58 +02:00
usb_mass_storage.go fix: recover HID chardev after DWC3 rebind race on RV1106 (#1366) 2026-03-28 20:56:21 +01:00
version.go feat: jetkvm native in cGo 2025-09-29 14:09:30 +02:00
video.go MQTT Support / Home Assistant Integration (#1195) 2026-03-24 13:49:07 +01:00
web.go feat: add custom broadcast IP option to Wake-on-LAN (#1238) (#1345) 2026-03-28 12:54:57 +01:00
web_tls.go Enhance synctrace logging (#980) 2026-01-28 09:19:56 +01:00
webrtc.go feat(video): add H.265 codec support with auto-negotiation (#1371) 2026-03-29 21:34:38 +02:00
wol.go feat: add custom broadcast IP option to Wake-on-LAN (#1238) (#1345) 2026-03-28 12:54:57 +01:00

JetKVM is a high-performance, open-source KVM over IP (Keyboard, Video, Mouse) solution designed for efficient remote management of computers, servers, and workstations. Whether you're dealing with boot failures, installing a new operating system, adjusting BIOS settings, or simply taking control of a machine from afar, JetKVM provides the tools to get it done effectively.

Features

  • Ultra-low Latency - 1080p@60FPS video with 30-60ms latency using H.264 encoding. Smooth mouse and keyboard interaction for responsive remote control.
  • Free & Optional Remote Access - Remote management via JetKVM Cloud using WebRTC.
  • Optional Tailscale Networking - Built-in Tailscale status and control-server configuration, including custom Headscale-compatible endpoints.
  • Open-source software - Written in Golang on Linux. Easily customizable through SSH access to the JetKVM device.

Contributing

We welcome contributions from the community! Whether it's improving the firmware, adding new features, or enhancing documentation, your input is valuable. We also have some rules and taboos here, so please read this page and our Code of Conduct carefully.

I need help

The best place to search for answers is our Documentation. If you can't find the answer there, check our Discord Server.

I want to report an issue

If you've found an issue and want to report it, please check our Issues page. Make sure the description contains information about the firmware version you're using, your platform, and a clear explanation of the steps to reproduce the issue.

Development

JetKVM is written in Go & TypeScript. with some bits and pieces written in C. An intermediate level of Go & TypeScript knowledge is recommended for comfortable programming.

The project contains two main parts, the backend software that runs on the KVM device and the frontend software that is served by the KVM device, and also the cloud.

For comprehensive development information, including setup, testing, debugging, and contribution guidelines, see DEVELOPMENT.md.

For quick device development, use the ./dev_deploy.sh script. It will build the frontend and backend and deploy them to the local KVM device. Run ./dev_deploy.sh --help for more information.

Backend

The backend is written in Go and is responsible for the KVM device management, the cloud API and the cloud web.

Frontend

The frontend is written in React and TypeScript and is served by the KVM device. It has three build targets: device, development and production. Development is used for development of the cloud version on your local machine, device is used for building the frontend for the KVM device and production is used for building the frontend for the cloud.