Advanced Usage
Developer Tools
JetKVM is open to tinkering. SSH into the device, flash your own firmware, or read its serial console while it boots.
Developer Mode
Developer Mode turns on SSH access. JetKVM only accepts key-based logins, so you need an SSH key; your JetKVM password doesn't work over SSH.
Create and copy an SSH key
- Open the Start menu, type PowerShell and open Windows PowerShell.
- Create a key:Terminal
ssh-keygen -t ed25519 - Press Enter to save it in
C:\Users\your-name\.ssh. If it asks to overwrite, typen: you already have a key, so skip to the last step. - Type a passphrase and press Enter, then type it again. Nothing shows as you type. To skip the passphrase, press Enter twice.
- Copy your public key to the clipboard:It's theTerminal
Get-Content ~\.ssh\id_ed25519.pub | Set-Clipboard.pubfile. Never share the one without.pub; that's your private key.
Add the key to JetKVM
- In the JetKVM web interface, open Settings and then Advanced.
- Check Developer Mode.
- Paste the key into SSH Public Key and click Update SSH Key.
Connect
- In the same terminal, run this with your JetKVM's IP address, shown on its front display:Terminal
ssh root@<jetkvm-ip-address> - The first time, SSH asks if you trust the device. Type
yesand press Enter. - If you set a passphrase, enter it when asked.
You're in a lightweight Linux system: BusyBox provides the shell and tools, and Dropbear the SSH server.
DFU mode
DFU (Device Firmware Update) mode flashes firmware over USB, without booting the installed system. Use it to test your own builds or to recover a device that won't start.
To flash your own build, follow DFU recovery and select your .img in place of the recovery image:
Serial Console
The serial console shows boot messages, system logs and other low-level output. Use it to debug the boot process or test new features.
JetKVM carries its serial console over the SBU pins of its USB-C port. To read it, plug a USB-C SBU serial adapter such as USB-Cereal between JetKVM and your computer, set it to 3.3 V, and open its serial port at 115200 baud. If nothing appears, flip the adapter's plug.
USB-Cereal at SolderedShips from the EUUSB-Cereal at Crowd SupplyShips from the US