Skip to content
LeafKVM
Guide References Contact

Firmware Upgrade

OTA Updates

Section titled “OTA Updates”

LeafKVM does NOT install updates automatically.

To keep your device up to date, you should periodically visit the Update page to check for new releases.

  1. Open the Web UI → Settings → Update page.
  2. If a new firmware version is available, a notification will appear on this page.
  3. You may then choose to download and install the update manually.

Advanced Update Options

Section titled “Advanced Update Options”

Within Web UI → Settings → Update → Advanced, additional developer-oriented features are available:

  • Custom Image — Allows specifying a custom firmware URL for direct installation.

    Useful for development builds or internal testing.

  • More Versions — Provides a list of recent releases.

    This enables upgrading to a newer version or rolling back to an earlier one when needed.

Release Notes

Section titled “Release Notes”

V0007

Section titled “V0007”

(Released: 09 Nov 2025)

Key Updates

  • Multi-language support added.
    The device now follows the browser language by default.
    (Some translations are still in progress and will be completed in upcoming releases.)
  • Mouse Jiggler feature introduced.
  • Fixed an issue where text could not be pasted from the browser into the target machine.
  • Updated keyboard/mouse transmission protocol to the latest upstream version, further reducing HID latency.

V0009

Section titled “V0009”

(Released: 20 Nov 2025)

Compared with V0007, this update includes:

Fixes & Improvements

  1. Fixed an issue where the mouse scroll wheel did not function.
    (Note: Trackpad scrolling on macOS is still not perfectly smooth — improvements planned for future versions.)
  2. Added HTTP-based ISO mounting, allowing devices to attach ISO images via URL.
  3. Resolved a Linux TTY issue where:
    • keyboard input could freeze, and
    • reconnecting after a page refresh sometimes failed.
  4. Added port forwarding support.
    With a public IP and appropriate TCP/UDP forwarding rules, LeafKVM can be accessed directly via the Internet.
  5. Added resize2fs to system images.
    For ext4-based firmware, the root filesystem can now be expanded.

Persistence Notice After firmware updates, only the following directories remain unchanged:

  • /userdata
  • /root
  • /opt

Please store any custom software or scripts in these locations.

For new systemd services, consult the community first — persistent service support is being evaluated.

UDP Port Forwarding Guide

Section titled “UDP Port Forwarding Guide”

To access a LeafKVM behind NAT from a public IP, you must forward:

  • TCP 80 — Web UI
  • UDP 58000 — WebRTC media transport

After configuring router rules, open Settings → Access and fill in the Additional UDP Endpoint with your DDNS domain or public IP and the forwarded UDP port.

Example (router public IP: 201.2.3.4 or my.example.com DDNS):

  1. Forward UDP 5123 → device:58000
  2. Forward TCP 8080 → device:80 (or reverse-proxy via HTTPS)
  3. In Additional UDP Endpoint:
    • 201.2.3.4:5123 (static IP), or
    • my.example.com:5123 (DDNS)

You can now access LeafKVM via the forwarded TCP 8080 port.

V0010 new

Section titled “V0010 ”

(Released: 08 Dec 2025)

New Features & Enhancements

  • Added WLAN country code selection (Settings → Advanced).
    This allows proper regional regulation compliance.
  • Keyboard macro functionality is now fully operational.
  • Devices with hardware revision V1.3 now display real-time USB input voltage on the home screen.
  • Added GUI screenshot capability (Settings → Advanced), allowing users to capture the touchscreen interface.
  • Added HTTPS access support.
    The Web UI can now be served securely over HTTPS.

© 2025 LeafKVM Team
Contact