# Verify an i9 release

Every release publishes a `release.json` naming the sha256 and size of each
platform binary, signed with an ECDSA P-256 release key. The installer at
<https://i9.io/vm> is rendered by i9.io only after that signature verifies,
and it checks the sha256 of the binary it downloads before running it. You can
check the same signature yourself, with no i9 code involved.

## Release keys

The key id is the first 8 bytes of the sha256 of the key's DER encoding;
recompute it with `openssl pkey -pubin -in release-signing.pub -outform DER | sha256sum`.

### `9bcabf33e1bafba6` (current)

```
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAECLOg4UFmMxWpQe7LcZ8RdLHmT8LR
YWMi/tm2qCkeBOxbHZVrrZzQDMp4KOZ4UVoIA5sL/c2VnlAWaSGe12A0qw==
-----END PUBLIC KEY-----
```

## Check a release

The current stable release is `v2026.11.17.151656-e4b2bb363`. Fetch its signed release data:

```sh
curl -fsSLO https://a.i9.io/i9/v2026.11.17.151656-e4b2bb363/release.json
curl -fsSLO https://a.i9.io/i9/v2026.11.17.151656-e4b2bb363/release.json.sig
curl -fsSLO https://a.i9.io/i9/v2026.11.17.151656-e4b2bb363/release.json.sigstore.json
curl -fsSLO https://i9.io/vm/release-signing.pub
```

With [cosign](https://docs.sigstore.dev/), which also checks the stable release's
entry in the public Rekor transparency log (a release whose fetch lines above
name no `release.json.sigstore.json` has no entry; check it with OpenSSL):

```sh
cosign verify-blob --key https://i9.io/vm/release-signing.pub --bundle release.json.sigstore.json release.json
```

A Rekor bundle is written when a release is promoted to stable, so an
edge release (`I9_CHANNEL=edge`) is signed but has no Rekor bundle. Check it,
or any release without one, with OpenSSL.

With OpenSSL only (`base64 -D` on macOS):

```sh
base64 -d release.json.sig > release.json.der
openssl dgst -sha256 -verify release-signing.pub -signature release.json.der release.json
```

Then compare the sha256 of the binary you have with its entry in `release.json`:

```sh
sha256sum ~/.i9/bin/i9        # shasum -a 256 on macOS
```

A withdrawn release is named in a separately signed withdrawal; i9.io refuses to
install one, and `i9 update` refuses to move to one.
