Releases
Download CherryPi.
One binary per platform, plus container images for the agency and agent. Every download points at the latest release on GitHub; the page refreshes itself when a new tag appears.
v0.6.0
published Nov 4, 2026 · baked into this build
CherryPi Agency
The web app, API, scheduler and tunnel hub. Run one per installation, on a VPS or home server.
CherryPi Agent
The worker. Hosts Pi sessions, PTYs and the desktop bridge on each machine that should do work.
Containers
Pull the images.
Published to GitHub Container Registry. The agency image is slim; the agent image carries the Pi runtime, Node and the desktop bridge.
cherrypi-agency
Web app + API + tunnel hub. Exposes port 8080.
$ docker pull ghcr.io/cherrypidotdev/cherrypi-agency:v0.6.0
also available as :latest
cherrypi-agent
Pi runtime + PTYs + desktop bridge. Dials out; no inbound port.
$ docker pull ghcr.io/cherrypidotdev/cherrypi-agent:v0.6.0
also available as :latest
Unzip the binary
Each archive contains exactly one executable. Move it somewhere on
your PATH and mark it executable.
Install the agency
Set CHERRYPI_ADMIN_PASSWORD and a data
directory, then put a TLS reverse proxy in front.
Register an agent
Create the agent in the UI, copy its one-time PAT and start the
agent with CHERRYPI_AGENT_TOKEN.
Looking for systemd units, desktop access or configuration? Read the documentation.