Skip to main content

IP-KVM

See and control machines through PiKVM, NanoKVM and JetKVM devices.

NetworkingSourceAPIChangelog
  • Works with PiKVM, GL.iNet Comet, NanoKVM and JetKVM
  • See the screen of a machine and use its keyboard and mouse in the browser
  • Termix connects to the KVM, so it works for KVMs your browser cannot reach
  • Power on, shut down, hard power off and reset through the KVM
  • Mount ISO images as a USB drive or CD (PiKVM, NanoKVM)
  • Ctrl+Alt+Del and other shortcuts, paste text and screenshots
  • Wake-on-LAN, alerts when a KVM goes offline, and the ip-kvm.power service
  • Link a KVM to a Termix host

IP-KVM lets you see and control the machines behind your IP-KVM devices from Termix. You get the screen, keyboard and mouse in the browser, power control, virtual media and shortcuts, even when the machine's operating system is down.

Supported KVMs​

TypeScreen and keysPowerVirtual media
PiKVMThrough Termix (MJPEG video, HID socket)ATX on, off, hard off, resetMount images, download from a web address
GL.iNet Comet (GLKVM)Through Termix (MJPEG video, HID socket)ATX on, off, hard off, resetMount images, download from a web address
NanoKVMThrough Termix (MJPEG video, HID socket)Power button and resetMount images already on the device
JetKVMDirect WebRTC from your browser to the KVMThrough the screen toolbarNot yet

The GL.iNet Comet runs PiKVM's software with a fixed admin user, so it only asks for the password. The PiKVM, NanoKVM and JetKVM drivers were written from each project's public API and have only been tested against fake devices so far. If one does not work on your hardware, please open an issue with the model and software version.

Add a KVM​

  1. Open the KVM tab from the sidebar and press Add KVM.
  2. Pick the type, give it a name and enter the KVM address.
  3. Optionally pick the Termix host the machine belongs to. The KVM then follows that host's sharing and shows in its host menu.
  4. Enter the login and press Test connection. A KVM with its own self signed certificate needs Trust this certificate first: Termix shows the certificate's fingerprint, and once you trust it, only talks to the KVM while it shows that exact certificate.
  5. Optionally fill in the MAC address of the machine to use Wake-on-LAN.
  6. Save. Termix checks the KVM right away and then every minute, or whatever you set.

The login is stored encrypted on the server and is never shown again. To replace it, edit the KVM and fill in the fields. Leave them empty to keep the saved one.

Certificates​

Most KVMs use a self signed certificate. Paste the certificate (or the authority that signed it) in PEM form under Certificate. Termix then trusts it for this KVM only. Without it, https fails. You can also pick http for KVMs that offer it on a trusted network.

Screen​

Termix connects to the KVM, reads its video and passes it to your browser, so the screen works even when your browser cannot reach the KVM. Click the screen to type. Your keys go to the machine, so browser shortcuts do not work while the screen has focus. Click outside the screen to get them back.

The toolbar has shortcuts like Ctrl+Alt+Del, Paste text (PiKVM only), Screenshot, Full screen and Reconnect. A session ends after the time set by the admin (4 hours by default).

Your browser decodes the video, so a 1080p stream needs a decent connection. Frames are dropped when your browser falls behind.

JetKVM​

A JetKVM sends its video over WebRTC, which Termix cannot decode on the server. Termix only passes the offer and the answer, so the video then goes straight from the JetKVM to your browser. Your browser must be able to reach the JetKVM on the network. The power buttons are in the screen toolbar and need the power permission.

Power​

The Power tab has Power on, Shut down (asks the OS to stop), Reset and Power off (cuts the power). Reset and Power off do not shut the system down cleanly, so Termix asks first. Wake on LAN sends a magic packet from the Termix server, so the server must be on the same network as the machine. You need the power permission.

Termix does not alert you about a power change it made itself. It does alert you when the power changes any other way, and when a KVM goes offline or comes back.

Virtual media​

The Virtual media tab lists the images on the KVM and mounts one as a CD drive or a USB drive. PiKVM can also download an image from a web address. The KVM downloads it, so the address must be reachable from the KVM. Pair it with the boot menu of the machine to install an operating system.

For other plugins​

The ip-kvm.power service lets other plugins read and set the power of the machine behind a KVM linked to a host. It is not offered for JetKVM, which has no power control on the server side.

Permissions​

PermissionDefault rolesWhat it allows
viewadmin, userSee KVMs and their state
poweradminPower changes and Wake-on-LAN
consoleadminScreen, keyboard, mouse and paste
mediaadminVirtual media
manageadminAdd, change and remove KVMs

A KVM linked to a host also needs the right access to that host: connect to see it and edit to use the screen or change anything.