Advanced Usage
Developing
JetKVM is built with developers in mind, providing tools and modes that allow you to explore, modify, and extend the functionality of the device. If you're interested in tinkering, testing new firmware, or contributing to JetKVM, here's an overview of the key development features.
Developer Mode
Developer Mode unlocks SSH access to the JetKVM device, allowing you to customize or modify the system. When you enable Developer Mode, you must provide an SSH public key, as JetKVM uses key-based authentication. For security reasons, you can not use your JetKVM password for SSH logins.
Generating an SSH Key
Before you can enable Developer Mode, you need to generate an SSH key pair.
On macOS and Linux:
- Open a terminal window.
- Run the following command to generate a new SSH key pair:
ssh-keygen -t rsa -b 4096
- You will be prompted to enter a file in which to save the key. Press Enter to accept the default location (
~/.ssh/id_rsa
). - You will be asked to enter a passphrase. This is optional but recommended for extra security.
- Your public key will be saved to
~/.ssh/id_rsa.pub
.
On Windows:
- Open PowerShell.
- Run the following command to generate a new SSH key pair:
ssh-keygen -t rsa -b 4096
- You will be prompted to enter a file in which to save the key. Press Enter to accept the default location (
C:\\Users\\YourUsername\\.ssh\\id_rsa
). - You will be asked to enter a passphrase. This is optional but recommended for extra security.
- Your public key will be saved to
C:\\Users\\YourUsername\\.ssh\\id_rsa.pub
.
Adding Your SSH Key to JetKVM
- Navigate to the JetKVM settings page.
- Go to the Advanced tab.
- Check the box to Enable Developer Mode.
- Open your public key file (
~/.ssh/id_rsa.pub
orC:\\Users\\YourUsername\\.ssh\\id_rsa.pub
) with a text editor and copy the entire content. - Paste the public key into the input box and save the changes.
Connecting to JetKVM
Once you have enabled Developer Mode and added your SSH public key, you can connect to the JetKVM device using an SSH client.
- Open a terminal (on macOS/Linux) or PowerShell (on Windows).
- Use the following command to connect to your JetKVM device:
Replacessh root@<jetkvm-ip-address>
<jetkvm-ip-address>
with the IP address of your JetKVM device. - If you set a passphrase for your SSH key, you will be prompted to enter it.
The system runs on a lightweight Linux environment using BusyBox as the core user space and DropBear as the SSH server.
For a full, in-depth guide on how to develop and contribute to the JetKVM, please see the DEVELOPMENT.md file on our GitHub.
DFU Mode (Device Firmware Update)
DFU Mode allows you to update the firmware of your JetKVM device, especially when standard access methods like SSH are not available or when testing new firmware. DFU mode provides a way to recover or upgrade the firmware without relying on the standard boot process.
How to Enter DFU Mode:
- Unplug the USB cable from the device.
- Locate the small hole on the right side of the device.
- Insert a needle into the hole and press & hold the button inside before reconnecting the USB cable.
- Hold the needle for three seconds, then release. Your device is now in DFU Mode.
Flashing New Firmware:
- Download the firmware update tool for MacOS & Linux or Windows.
- Compile your firmware into an
.img
file. - Run the following command in your terminal:
sudo ./upgrade_tool uf your_firmware.img
- The tool will display progress, and once completed, the JetKVM device will boot with the new firmware.
Serial Console
A serial console provides direct access to system logs, boot messages, and other low-level interactions. It is essential for debugging and monitoring the device during the boot process or when testing new features.
Since modern computers no longer include traditional serial ports, JetKVM uses a UART splitter to provide serial console access. The UART signal is multiplexed over the SBU (Sideband Use) pins of the USB cable, so you'll need a UART splitter to connect to the serial console.