Relay changelog

The relay is the optional program, consolet relay, that you run on an always-on machine at home. Download and install it. The app has its own changelog.

2026.11.2 — 16 November 2026

The relay can put your phones' keys on your machines.

  • With the switch on for a machine (in the app from 2026.11.8), the relay adds the SSH key of every phone paired with it to ~/.ssh/authorized_keys, and takes it off when a phone is removed. Lines you put there yourself are never touched.
  • consolet relay devices shows the fingerprint of each device's key.

2026.11.1 — 11 November 2026

The first published release of the relay.

What it does

The relay watches the machines of one home for the phones paired with it. It checks whether each answers, signs in with its own SSH key to read its CPU, memory and network and what Claude Code's hook records, and keeps a day of history. It sends Wake-on-LAN packets from inside the home, and reboots or shuts a machine down when a paired phone asks.

It also reads the PiKVM or JetKVM of a machine, if the home names one: the power lights, a picture of the screen and, for a JetKVM, the DC power board. It presses a PiKVM's ATX buttons, and a JetKVM's ATX and DC power, when a phone asks.

On Linux it also lists the machines its home network knows, from the system's own table of neighbours and their names, when a phone that manages it asks; the app uses that list to fill in Add a machine. Nothing is sent to those machines to find them.

Away from home

A phone reaches the relay on the home network, over your own VPN and, signed in with Pro, through our server, always through an encrypted channel of its own that our server passes and cannot read. Unless it is started with --no-backend, the relay links to our server while a pairing is open or a paired phone has named its account; that link is what the last way depends on.

Pairing, phones and roles

A phone pairs with a code that the relay prints, good for 10 minutes and for one phone. With sync on, the phones of one person join a relay by themselves, in the background, with no code, once one of them has paired. A phone either manages the relay or only uses it, and each phone can be removed alone with consolet relay remove.

New for anyone who built it before

  • Linux, macOS and Windows. The relay runs on all three. There are builds for Linux on x86-64, ARM64 and ARMv7, and for MIPS and MIPS little-endian (soft-float, for routers), for macOS on Apple silicon and on Intel, and for Windows on x64 and ARM64.
  • relay install on all three. sudo ./consolet relay install sets up the relay as a service on Linux (systemd) and macOS (launchd), and consolet.exe relay install does it on Windows. relay uninstall removes the service and keeps the state.
  • Updates. The relay updates itself once a day, to a newer release signed with the author's key, after checking its size and SHA-256. It asks this site first and the copy at downloads.gpm-apps.com only when this site does not answer. relay install turns them on by default on Linux and macOS (--no-update leaves them off), as it already did on Windows.
  • Downloads. The files are on this site, and every release is kept at downloads.gpm-apps.com/consolet/relay/.