One-KVM
An open, lightweight IP-KVM stack in Rust — remote management down to BIOS level
Overview
One-KVM (Rust) is a lightweight IP-KVM solution written in Rust. It lets you manage servers and workstations over the network, including at BIOS level.
Goals: an open, lightweight, easy-to-use IP-KVM stack.
- Open: not tied to one hardware recipe; runs across many setups.
- Lightweight: shipped as a binary with minimal moving parts for deployment.
- Easy to use: no hand-edited config files required; settings are done in the web UI.
For more information, see the One-KVM Rust documentation.
One-KVM (Python) is no longer maintained. If you still need it, see https://github.com/mofeng-git/One-KVM/tree/python.
Features
Core
| Area | Capabilities |
|---|---|
| Video capture | HDMI USB / MIPI CSI / RK3588 HDMI IN; MJPEG and WebRTC (H.264 / H.265 / VP8 / VP9) |
| Video encoding | VAAPI / QSV / RKMPP / V4L2 M2M hardware paths, with software fallback |
| Keyboard & mouse | USB OTG HID or CH340 + CH9329 HID; absolute / relative mouse |
| Virtual media | USB mass storage; ISO/IMG mount and Ventoy-style virtual USB |
| ATX power | GPIO or USB relay; power control |
| Audio | ALSA capture + Opus (HTTP / WebRTC) |
Installation
Release artifacts are on GitHub Releases. Below are short paths for common setups. For system requirements, hardware, Docker env vars, USB OTG, and full troubleshooting, see the One-KVM documentation (Chinese; use a translator if needed).
Debian / Ubuntu (.deb)
Download a one-kvm_*.deb matching your CPU architecture from Releases, then from the directory containing the package:
sudo apt update
sudo apt install ./one-kvm_0.x.x_<arch>.deb
Replace the version and architecture in the filename with your actual file name.
Docker
Images:
- one-kvm — main app + ttyd
- one-kvm-full — same plus optional extras (e.g. gostc, easytier-core)
Example:
docker run --name one-kvm -itd \
--privileged=true --restart unless-stopped \
-v /dev:/dev -v /sys:/sys \
--net=host \
silentwind0/one-kvm-full
If pulls are slow, use the Aliyun mirror, e.g. registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm-full (and registry.cn-hangzhou.aliyuncs.com/silentwind/one-kvm for the slim image).
fnOS NAS (Feiniu / 飞牛)
One-KVM is listed in the fnOS app store; search and install on your NAS.
Web UI and first run
Open http://<device-ip>:8080 in a browser (8420 after fnOS install). The first visit runs initial setup.
Reporting issues
If something breaks:
- Open GitHub Issues or report in the project QQ group.
- Include useful error messages and steps to reproduce.
- Mention software version, hardware, and OS details.
Sponsorship
One-KVM builds on many great open-source projects; a lot of time goes into testing and maintenance. If you find it useful, you can support development on Afdian (为爱发电).
Thanks
Supporter list
-
浩龙的电子嵌入式之路
-
Tsuki
-
H_xiaoming
-
0蓝蓝0
-
fairybl
-
Will
-
自.知
-
观棋不语٩ ི۶
-
爱发电用户_a57a4
-
爱发电用户_2c769
-
霜序
-
远方(闲鱼用户名:小远技术店铺)
-
爱发电用户_399fc
-
斐斐の
-
爱发电用户_09451
-
超高校级的錆鱼
-
爱发电用户_08cff
-
guoke
-
mgt
-
姜沢掵
-
ui_beam
-
爱发电用户_c0dd7
-
爱发电用户_dnjK
-
忍者胖猪
-
永遠の願い
-
爱发电用户_GBrF
-
爱发电用户_fd65c
-
爱发电用户_vhNa
-
爱发电用户_Xu6S
-
moss
-
woshididi
-
爱发电用户_a0fd1
-
爱发电用户_f6bH
-
码农
-
爱发电用户_6639f
-
jeron
-
爱发电用户_CN7y
-
爱发电用户_Up6w
-
爱发电用户_e3202
-
一语念白
-
云边
-
爱发电用户_5a711
-
爱发电用户_9a706
-
T0m9ir1SUKI
-
爱发电用户_56d52
-
爱发电用户_3N6F
-
DUSK
-
飘零
-
.
-
饭太稀
-
葱
-
MaxZ
-
爱发电用户_c5f33
-
爱发电用户_09386
-
爱发电用户_JT6c
-
爱发电用户_d3d9c
-
爱发电用户_97b41
-
偶然
-
爱发电用户_dba45
-
爱发电用户_d4f8b
-
故人。
-
......
Sponsors
File hosting
- Huang1111 public-interest program — login-free downloads
Cloud
- 林枫云 — project server sponsorship
林枫云 offers premium network routes, high-frequency game servers, and high-bandwidth servers in China and abroad.
- Beta Network — project server sponsorship
Remote computers, consumer GPU servers, and dedicated physical machines with fully automated online delivery.

