The relay

The relay is an optional program, consolet relay, that you run on a machine of yours that is always on at home: a NAS, a mini PC, a Mac, a Windows PC. It watches the machines of that home for the app, sends their Wake-on-LAN packets from inside the home, reads their KVMs (PiKVM and JetKVM) and reboots or shuts a machine down when a paired phone asks. The phone then does all of that from anywhere: it reaches the relay on the home network, over your own VPN or, with Pro, through our server, always in an encrypted channel of its own that our server passes and cannot read. You need no relay to use the app. What the relay sends and keeps is in the privacy policy; what each release changed is in its changelog.

Download

Version 2026.11.5, released 2026-11-16. Pick the file for the machine the relay will run on.

SystemFileSizeSHA-256
Linux
Linux x86-64 consolet-linux-amd64 12.0 MB 1d06fb4a0f8ba6c9c96a715aebb4b9a5edb8ae15c990b6b83e8d8dffef842df8
Linux ARM64 consolet-linux-arm64 11.1 MB 9638662002cc7e6a81e06a2f99da54d92ce2adb61b9abe291429f23705ec36da
Linux ARMv7 consolet-linux-armv7 11.3 MB cacdd6ee28ceac039b9241bad1595f414da805826f0f5982530edbdfa206f4d0
Linux MIPS (routers) consolet-linux-mips 12.9 MB 1be01cddd2be395259a4367f3ed5af5d18adeeebcab9a130c4388ac0ab92723f
Linux MIPS little-endian (routers) consolet-linux-mipsle 12.9 MB 22c37ff48e5d67c6459801ddc13522e99cd1c155654622cc888b30cc92dab85d
macOS
macOS, Apple silicon consolet-darwin-arm64 11.3 MB 9ae47f8cee6c0991d893fb38597e1281ff4a18dbbfcf6954106786b0d8575212
macOS, Intel consolet-darwin-amd64 12.2 MB d924ed7e38924e0ed0658c1856e6fb783955807c46f794c1e822467233313e43
Windows
Windows x64 consolet-windows-amd64.exe 12.3 MB d9869ca1f5b5f41ec9cd5a28a6fb65f9fc95dac38e8b0b631d7c2f49d38f175a
Windows ARM64 consolet-windows-arm64.exe 11.2 MB 5a79d4ed3928f89647f0805a8d379d6b8db967fc52ac8beb553ed1a32e368d4e

The release is signed with the author’s key (latest.json and latest.json.sig are in the same directory), and the relay checks that signature before it installs an update. The SHA-256 above lets you check a download by hand: sha256sum consolet-linux-amd64 on Linux, shasum -a 256 consolet-darwin-arm64 on macOS, Get-FileHash in PowerShell.

Every release is also kept at downloads.gpm-apps.com/consolet/relay/. This site holds only the latest one.

Install

Install it on the machine that will run it, and run each command there. The programs are not signed with an Apple or a Microsoft certificate, which is why the macOS and Windows steps below mention what those systems say about that. The macOS and Windows builds are new in this release, and have been built but not yet run on a real Mac or Windows PC.

Linux

With systemd. Pick the file for your machine’s architecture from the table (consolet-linux-arm64 for a Raspberry Pi or a NAS on a 64-bit ARM chip, consolet-linux-armv7 for a 32-bit one):

curl -fLo consolet https://consolet.gpm-apps.com/relay/2026.11.5/consolet-linux-amd64
chmod +x consolet
sudo ./consolet relay install

relay install copies the program to /usr/local/bin/consolet, installs and starts the service consolet-relay.service and turns on the daily update timer consolet-relay-update.timer, unless you add --no-update. It refuses on a system without systemd, and where the relay is already installed. The two MIPS builds are for routers, which have no systemd: run consolet relay under your router’s own service manager.

macOS

Use consolet-darwin-arm64 on an Apple silicon Mac and consolet-darwin-amd64 on an Intel one. Download it with curl and not with a browser: a file downloaded with a browser is quarantined, and Gatekeeper refuses a program that is not signed with an Apple certificate.

curl -fLo consolet https://consolet.gpm-apps.com/relay/2026.11.5/consolet-darwin-arm64
chmod +x consolet
sudo ./consolet relay install

If you already downloaded it with a browser, xattr -d com.apple.quarantine consolet clears the flag. relay install copies the program to /usr/local/bin/consolet, keeps its state in /Library/Application Support/consolet/relay, and starts it as a launchd daemon, name.gpm.consolet.relay, which starts with the Mac. Its log is /Library/Logs/consolet-relay.log. Updates are on unless you add --no-update.

Windows

Use consolet-windows-amd64.exe on most PCs and consolet-windows-arm64.exe on an ARM one. In PowerShell opened as administrator:

Invoke-WebRequest -Uri https://consolet.gpm-apps.com/relay/2026.11.5/consolet-windows-amd64.exe -OutFile consolet.exe
.\consolet.exe relay install

Windows SmartScreen may say “Windows protected your PC” about a download that is not signed: choose “More info”, then “Run anyway”. relay install copies the program to %ProgramFiles%\consolet\consolet.exe and registers and starts the service consolet-relay, which starts with the machine. Updates are on unless you add --no-update.

Pair it with the app

On the relay’s machine, run the command as administrator or with sudo, so that it reads the service’s state:

sudo consolet relay pair

On Windows, from an elevated prompt, use the installed copy: & "$env:ProgramFiles\consolet\consolet.exe" relay pair.

It prints a QR code and a code, good for 10 minutes and for one phone, with a line for each way to reach the relay. In the app, open Settings, Relays, Pair a relay, and scan the QR code, or type one of the lines, or choose the relay the app found on your Wi-Fi and type the code alone.

Away from the relay’s network, the QR code and the first lines work through your own VPN when the phone and the relay are both on it. With Pro, and the phone signed in, the last line, which starts with the relay’s id, pairs through consolet from anywhere; it appears once the relay has reached our server.

The relay then needs the key it prints with sudo consolet relay key added to the authorized_keys of each machine it should watch. On Linux and macOS, relay pair offers to add it on the relay’s own machine, for the user who ran sudo, once a phone has paired; on the other machines the app can do it for you, after asking.

Claude Code

On the machine where Claude Code runs, install consolet as above; it does not need to run as a relay there. Add its hook to ~/.claude/settings.json, merged with any hooks already there:

{
  "hooks": {
    "Notification":      [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }],
    "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }],
    "PostToolUse":       [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }],
    "UserPromptSubmit":  [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }],
    "Stop":              [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }],
    "SessionEnd":        [{ "hooks": [{ "type": "command", "command": "consolet hook" }] }]
  }
}

Use the full path if consolet is not on the PATH Claude Code sees. Put it on the PATH, for instance in /usr/local/bin: the app and the relay run consolet claude --json there over SSH. The app then shows when Claude is waiting for you and what it asks.

Updates

Once a day, after a random delay of up to 6 hours, the relay asks this site for latest.json and its signature, and only if the release they name is newer than its own, for the file for its system. It installs a newer version only if the release is signed with the author’s key and the file’s size and SHA-256 are the ones the signed list names, and never an older version. If this site does not answer, it asks the copy at downloads.gpm-apps.com.

It sends nothing but those requests, with a User-Agent of the form consolet/<version> (<os>/<arch>): no relay id, no account, no cookie. The privacy policy has the rest.

On Linux, if the relay does not come back after the restart that follows an update, the old program is put back. On macOS and Windows nothing puts it back.

To turn updates off, install with --no-update. On Linux you can also turn them off later with sudo systemctl disable --now consolet-relay-update.timer. On macOS and Windows, remove the service (below) and install it again with --no-update. You can always check by hand with consolet relay update --check, which changes nothing.

Remove it

sudo consolet relay uninstall

On Windows, consolet.exe relay uninstall from an elevated prompt. This stops and removes the service and keeps the relay’s state (its keys, the paired phones and the machines they sent). Delete the state directory to remove that too: /var/lib/consolet-relay on Linux, /Library/Application Support/consolet/relay on macOS, %ProgramData%\consolet\relay on Windows. To remove a single phone, sudo consolet relay devices lists them and sudo consolet relay remove <id> removes one.

The changes of each release are in the relay changelog.