Docker Install¶

This guide explains how to deploy One-KVM with Docker.

Prerequisites¶

System requirements: Linux (Debian/Ubuntu recommended) with Docker installed.
Hardware: enable USB OTG or connect a CH340 + CH9329 HID cable (for HID emulation), and connect a USB video capture card.

The OTG enable command varies by CPU platform (Allwinner, Amlogic, Rockchip, etc.). Check platform documentation for the exact command.

docker run --name one-kvm -itd --privileged=true \
  -v /dev:/dev  -v /sys/:/sys \
  --net=host \
  silentwind0/one-kvm

Open a browser and visit http://<device-ip>:8080

First-time Access

On the first visit, the system will guide you through initial setup, including creating the admin account.

Variable	Default	Description
`TZ`	`UTC`	Time zone
`HTTP_PORT`	`8080`	HTTP port
`HTTPS_PORT`	`8443`	HTTPS port
`ENABLE_HTTPS`	`false`	Enable HTTPS service (true/false)
`DATA_DIR`	`/data`	Data directory
`VERBOSE`	`0`	Log verbosity: 1 (-v), 2 (-vv), 3 (-vvv). Higher is more verbose

Notes

When HTTPS is enabled, no extra certificate mount is required; a default self-signed certificate is used.
--privileged=true and the /dev and /sys mounts are required for hardware access and cannot be omitted currently.
--net=host ensures ports are exposed directly; no -p mappings are needed.