Onboarding
From signup to your first analyzed pull request in under five minutes. Each step is guided in-app, with a progress rail that lets you skip the optional sections and come back later.
Free 14-day Pro trial
Every new org gets a 14-day Pro trial. No credit card. You'll get two heads-up emails (day 7 and day 13) before it expires. If you don't add a card, you downgrade to Hobby — no data loss.
The nine steps
- Connect GitHub — OAuth to link your user account.
- Install the GitHub App — On the org you want to govern. Select all repos or pick a subset.
- Import repositories — Veriva pulls metadata and profiles each repo (7-day cache).
- Choose a plan — Hobby (free), Pro, Ultra, or Enterprise. Starts your trial if paid.
- Pick a merge policy mode — Advisory, Warn, Standard (default), Strict, or Locked. See Merge Policy.
- Register agents — Optional. Issue a token per agent identity for trust scoring. See Agents.
- Configure hooks — Optional. Add a shell or webhook hook. See Hooks.
- Notification preferences — Weekly digest, immediate critical alerts, cost alerts.
- Invite teammates + MFA — Required for OWNER role if MFA enforcement is turned on.
What happens after onboarding
The moment the GitHub App is installed, Veriva subscribes to the org's webhook stream. The next open or sync event on any selected repo runs through the full ten-stage pipeline. You'll see the check-run in GitHub and a rich findings view in the Veriva dashboard.
Incomplete onboarding banner
If you skip optional steps, your dashboard shows an "Finish onboarding" banner until every required step is done. Owners can dismiss it per-user.
Common issues
- App install succeeds but no PRs appear — Check the repo list on the install. Pull requests opened before the install don't auto-analyze. Push a new commit or reopen the PR.
- Webhook 401s in audit — GitHub webhook secret rotation. Reinstall the app.
- MFA enforcement lockout — An OWNER can grant a 72h grace override from
/dashboard/settings/account.