Skip to content
gridtrue
Log in Sign up
Docs Getting started

Quickstart

Add gridtrue as a remote and ship your first signed commit in ten minutes.

This is the fastest path to a green attestation on your own code. It assumes you already have git, Docker (or Podman), and a repository you can push to.

  1. 1

    Install the CLI

    Grab the latest binary for your platform. The installer drops the gridtrue binary into your PATH and nothing else.

    # macOS / Linux
curl -fsSL https://gridtrue.io/install.sh | sh

# Windows (PowerShell)
iwr -useb https://gridtrue.io/install.ps1 | iex
  2. 2

    Enroll your identity

    gridtrue login opens the browser, authenticates you, and provisions an enrollment cert that lands in your OS keyring. No file lying around in ~/.gridtrue you could accidentally commit.

    gridtrue login
  3. 3

    Create a free org

    A gridtrue organization is a private network channel. The Free tier is forever free, no credit card, unlimited seats.

    gridtrue org create acme
  4. 4

    Add gridtrue as an additional remote

    Your canonical origin does not move. gridtrue joins the list of remotes. Push to it first, get the attestation, then fan out to your canonical host.

    cd ~/src/payments
git remote add gridtrue git@gridtrue.io:acme/payments.git
git push --set-upstream gridtrue main
  5. 5

    Run your first validation

    gridtrue validate reads the manifest in .gridtrue/validate.yaml (the CLI scaffolds a default one on the first run), executes it in a container, and signs the result.

    gridtrue validate
# → ✓ build    (2.1s)
# → ✓ test     (4.8s)
# → ✓ signed attestation 0x7a…3e

What to try next

  • Enable the pre-push hook so every push auto-validates: gridtrue hooks install.
  • Open a second clone, edit the same file, watch Conflict Radar pick up the overlap.
  • Author a policy contract that requires two distinct build attestations before any commit lands on main.
  • Export your ledger with gridtrue export. Run the exit drill now, not in six months.