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.

Install BothyRead the docs

The whole install, as typed
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.

  1. Download one binary

    The bothy command 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.

  2. Read the plan first

    bothy install --dry-run prints every action marked do or skip and changes nothing. A step marked skip is already true on your machine, which is why running it twice is safe.

  3. Install

    bothy install pulls 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 sha256 digest, 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 install says 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.

  1. 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.

  2. Designed, not built

    Bothy

    four walls and a fire

    Bivvy plus metrics, logs, alerts and backups.

  3. Designed, not built

    Basecamp

    everything before the climb

    Bothy plus dashboards, single sign-on, a database and a cluster view.

  4. 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 uninstall removes what it made and keeps your data and secrets unless you ask for --purge and 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 amd64 binary has been run end to end. The arm64 build 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.

Open the guide