Skip to main content

Self-hosting

The CLI is fully self-contained — it needs nothing but Node, a browser, and your repo. Baselines live in Git; reports are local files. Run it anywhere you run CI.

Git-native baselines

Baselines are stored in a Git orphan branch (frontguard-baselines) by default. This keeps baseline images out of your main branch history while still being version-controlled. The manifest tracks which routes, viewports and browsers were captured and when.

Docker

An official image bundles Node, Playwright and the browsers, so there's nothing to install in CI.

terminal
$ docker run --rm -v $PWD:/app \
    -e FRONTGUARD_OPENAI_KEY=$OPENAI_KEY \
    ghcr.io/ravidsrk/frontguard run --url https://staging.example.com

Optional cloud platform

For teams that want a hosted dashboard, baseline approvals, monitoring schedules and usage metering, the cloud platform runs on Cloudflare Workers + D1 + R2 and is self-deployable. The CLI never depends on it.

No per-screenshot pricing, no vendor lock-in. Everything that runs in the hosted product is open source and can run on your own infrastructure.