A bothy is a free shelter in the hills. This one is for your machine.
Bothy is a self-hosted console for one machine. It discovers the services on a machine, shows them on one page, and gives you a reader for the files and notes kept there. You get it from one download and one command, with no checkout and nothing to build.
curl -fsSLO https://github.com/YehudaBriskman/Bothy/releases/download/v2026.11.2/bothy_2026.11.2_linux_amd64.tar.gz
tar -xzf bothy_2026.11.2_linux_amd64.tar.gz && install -D bothy ~/.local/bin/bothy
bothy install --dry-run # read the plan
bothy install
Your machine needs Docker. Nothing here runs as root.
Installs like an app
The goal is the way you install a browser or an editor: get one file, run it, and the rest is its job. That is how it works now, for the first size.
Download one binary
The
bothycommand is a single static file attached to each GitHub release. It carries the stack definition inside it, so there is no repository to clone and no Go, Python or Node to install.Read the plan first
bothy install --dry-runprints every action markeddoorskipand changes nothing. A step markedskipis already true on your machine, which is why running it twice is safe.Install
bothy installpulls each image by its digest, starts the stack, then checks the bytes the server actually returns. It does not trust a status code, because a catch-all page also answers 200.
What it checks before it touches anything
- The release manifest must match its own line in the release’s
checksums.txt, and must name the same version as the binary. - Every image is pulled by
sha256digest, never by a tag, and the digest is re-checked after the pull. - When the GitHub CLI is present, the release’s build attestation is verified too. When it is not,
bothy installsays it skipped that check and prints the exact command to run yourself. - It writes under your home directory, never runs
sudo, and a failure part-way is resumed by running it again.
Four sizes
Bothy comes in sizes, named for the shelters people use in the hills, smallest first. Only the smallest can be installed today.
Installable now
Bivvy
a roof, a door, a lock
The console, a read-only file reader and the edge that serves them. Runs on Docker Compose.
Designed, not built
Bothy
four walls and a fire
Bivvy plus metrics, logs, alerts and backups.
Designed, not built
Basecamp
everything before the climb
Bothy plus dashboards, single sign-on, a database and a cluster view.
Designed, not built
Cairn
stack your own stones
Pick modules one at a time.
Where it honestly stands
Written against release 2026.11.2.
What has been shown to work
- A stock install of a real release on a clean Ubuntu virtual machine that had only Docker and Compose: download the binary,
bothy install, and the page and file reader answered with the right bytes. - Running the install a second time changes nothing and takes about a second.
- A tampered manifest, a wrong version and two forced failures were each refused or rolled back to the previous state.
bothy uninstallremoves what it made and keeps your data and secrets unless you ask for--purgeand type a confirmation.
What is not there yet
- Bothy, Basecamp and Cairn are plans. There is no way to install them yet.
- Only the Linux
amd64binary has been run end to end. Thearm64build exists and has never been executed. - The macOS and Windows archives are command-line clients. The stack itself runs on a Linux machine with Docker.
- WSL and rootless Docker are untested. There is no package for apt or Homebrew yet.
- The attestation check inside a fresh machine is proven only where the GitHub CLI was already signed in.
- This site is English only for now. Hebrew is planned and the pages are built so it can be added.
The full record of what was measured is in the repository. Install notes and test results
Documentation
The guide is the repository’s own Markdown, rendered here from the same files. It starts with installing and ends with troubleshooting.