diff --git a/CHANGELOG.md b/CHANGELOG.md index 3396e24..3183700 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,12 @@ uses [Semantic Versioning](https://semver.org/). lea's CA, trust store, audit volume and proxy address; the supported versions table up to v0.12.0. `pages.yml` pins its actions by commit SHA, as `SECURITY.md` says. +- The install steps (README, `docs/install.md`, the site) name cosign + v2.5.0 or later and lockhub's `lox` v0.12.1 or later beside lea v0.16.0 + or later: the `lockhttp` formula pulls in neither `lox` nor cosign, and + `lox add` and `lox run` verify every image with cosign (lockssh#44, + lockfamily#70). The brew line is + `brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign`. ## [0.12.0] - 2026-11-14 diff --git a/README.md b/README.md index 69caf39..ebc1e8f 100644 --- a/README.md +++ b/README.md @@ -66,19 +66,27 @@ In-agent approval is a convenience; a separate approval process is a boundary. ## Install +lockhttp needs lockhub's `lox` v0.12.1 or later (it passes +`--runtime-gids` to the lockhttp v0.12 console), cosign v2.5.0 or later +(`lox add` and `lox run` verify every image with it) and +[lea](https://github.com/DavidGodefroid/lea) v0.16.0 or later. The +`lockhttp` formula pulls in none of them: name them with it. + ```sh brew trust davidgodefroid/tap -brew install davidgodefroid/tap/lox davidgodefroid/tap/lockhttp +brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign brew install davidgodefroid/tap/lea ``` lockhttp runs in Docker: Homebrew installs the `lockhttp` launcher, which runs every command in the release's signed image. `lox` is lockhub's CLI, and the gate runs inside [lea](https://github.com/DavidGodefroid/lea). The whole -family instead: `brew install davidgodefroid/tap/lockfamily`. +family instead, `lox` and cosign included: +`brew install davidgodefroid/tap/lockfamily`. Without Homebrew, the Lock Family's installer puts the same tools in -`~/.local/bin` ([lockfamily install](https://github.com/DavidGodefroid/lockfamily/blob/main/docs/install.md)): +`~/.local/bin` ([lockfamily install](https://github.com/DavidGodefroid/lockfamily/blob/main/docs/install.md)); +cosign v2.5.0 or later must be on `PATH`: ```sh curl -fsSL https://lockfamily.dev/install.sh | sh diff --git a/docs/install.md b/docs/install.md index 278879f..9682467 100644 --- a/docs/install.md +++ b/docs/install.md @@ -13,7 +13,12 @@ a shell script that runs every command in the release's image (`ghcr.io/davidgodefroid/lockhttp:X.Y.Z`, amd64 and arm64). With Homebrew: `brew trust davidgodefroid/tap` (Homebrew asks to trust a third-party tap once), then `brew install davidgodefroid/tap/lockhttp` (or -`davidgodefroid/tap/lockfamily` for the whole family). Without Homebrew, +`davidgodefroid/tap/lockfamily` for the whole family, `lox` and cosign +included). The `lockhttp` formula pulls in neither `lox` nor cosign: name +them with it, `brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign`. +lockhttp v0.12 needs lockhub's `lox` v0.12.1 or later (it passes +`--runtime-gids` to the console) and cosign v2.5.0 or later (`lox add` +and `lox run` verify every image with it). Without Homebrew, the Lock Family's installer puts the same launcher in `~/.local/bin` ([lockfamily install](https://github.com/DavidGodefroid/lockfamily/blob/main/docs/install.md)): @@ -73,7 +78,7 @@ the lock's name): see lockhub's # 1. Install the Lock Family (lox, lea and the launchers), or only this tool; # Homebrew asks to trust a third-party tap once brew trust davidgodefroid/tap -brew install davidgodefroid/tap/lockfamily # or: brew install davidgodefroid/tap/lockhttp +brew install davidgodefroid/tap/lockfamily # or, with lox and cosign: brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign # or the launcher alone: see Install # 2. In lea's projects directory (LEA_PROJECTS_DIR: lea reads diff --git a/site/index.html b/site/index.html index 7878443..f1e343f 100644 --- a/site/index.html +++ b/site/index.html @@ -62,9 +62,9 @@

Your agent browses. You hold the key.
Install with Homebrew
brew trust davidgodefroid/tap
-brew install davidgodefroid/tap/lox davidgodefroid/tap/lockhttp
+brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign
 brew install davidgodefroid/tap/lea
-

Needs Docker. The gate runs inside lea, hence its formula. Then lox add lockhttp, lox run, and LEA_LOCKHTTP=1 in lea’s lea.conf. The whole family: brew install davidgodefroid/tap/lockfamily.

+

Needs Docker, lockhub’s lox v0.12.1 or later and cosign v2.5.0 or later, which lox verifies every image with. The gate runs inside lea, hence its formula. Then lox add lockhttp, lox run, and LEA_LOCKHTTP=1 in lea’s lea.conf. The whole family, lox and cosign included: brew install davidgodefroid/tap/lockfamily.

Install guide diff --git a/site/install/index.html b/site/install/index.html index a29e1eb..6113c35 100644 --- a/site/install/index.html +++ b/site/install/index.html @@ -65,9 +65,9 @@

With Homebrew

Install with Homebrew
brew trust davidgodefroid/tap
-brew install davidgodefroid/tap/lox davidgodefroid/tap/lockhttp
+brew install davidgodefroid/tap/lockhttp davidgodefroid/tap/lox cosign
 brew install davidgodefroid/tap/lea
-

Homebrew asks you to trust a third-party tap once. brew install davidgodefroid/tap/lockfamily installs the whole family instead.

+

Homebrew asks you to trust a third-party tap once. The lockhttp formula pulls in neither lox nor cosign: name them with it. brew install davidgodefroid/tap/lockfamily installs the whole family instead, lox and cosign included.

  1. In lea’s projects directory (LEA_PROJECTS_DIR), lox add lockhttp asks only for the lock’s name. It writes the policy, runs lockhttp doctor --fix, shows a short review and starts the console.

    @@ -94,16 +94,17 @@

    Without Homebrew

    lockhttp version

    It verifies the cosign signature of each release and of its image. The launcher runs the image by its digest. lea uses this launcher from v0.16.0.

    -

    cosign is required. Linux (Docker Engine) and macOS (Docker Desktop); on Windows, WSL 2 with Docker Desktop.

    +

    cosign v2.5.0 or later is required. Linux (Docker Engine) and macOS (Docker Desktop); on Windows, WSL 2 with Docker Desktop.

    Requirements

      -
    • Docker, and cosign for the Lock Family installer.
    • -
    • lea: it runs the agents in containers on internal networks, and runs the gate beside its proxy (Docker, or rootless Podman).
    • -
    • lockhub’s lox: the gate runs hub-attached only, and you answer held requests on the hub.
    • +
    • Docker.
    • +
    • cosign v2.5.0 or later on PATH: lox add and lox run verify every image with it, and the Lock Family installer checks the release’s and the image’s signatures.
    • +
    • lea v0.16.0 or later: it runs the agents in containers on internal networks, and runs the gate beside its proxy (Docker, or rootless Podman).
    • +
    • lockhub’s lox v0.12.1 or later: it passes --runtime-gids to the lockhttp v0.12 console; the gate runs hub-attached only, and you answer held requests on the hub.