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.
| System | File | Size | SHA-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.