WarrPilot — Runbook

environment: dev · host: ext-dev.warrcloud.org · ← builds & downloads

Install — Load Unpacked (dev testers)

Download the latest zip from the builds page.
Unzip it.
Open chrome://extensions, enable Developer mode.
Click Load unpacked and select the unzipped folder.

Chrome refuses to install a raw .crx via drag-and-drop (CRX_REQUIRED_PROOF_MISSING) — use the zip for manual installs.

Update

Managed installs update automatically on Chrome's next poll (a few hours), or force it via chrome://extensions → "Update". Load-Unpacked testers re-download the latest zip and reload.

Rollback

Chrome blocks downgrades — you cannot serve an older version under the same channel. To roll back, bump the manifest version above the bad one and re-publish the known-good code.

Troubleshooting sign-in

"Authorization page could not be loaded." — the build was packaged without VITE_COGNITO_DOMAIN, so it falls back to an invalid Cognito endpoint. Use a CI-built artifact (this host), never a hand-built local zip.
"app_not_configured_for_user" (Google 403). — the Google Workspace SAML app is not enabled for that user's OU. Fix in Google Admin Console → Apps → Web and mobile apps → the SAML app → User access (per organizational unit).