Skip to main content
The LaneSync GitHub App connects your repositories to the hosted SaaS at lanesync.dev. Installation triggers repository discovery, webhook subscription, and the repo setup wizard.

​
Installation flow

1

Sign in to LaneSync

Go to lanesync.dev and authenticate with GitHub OAuth.
2

Start installation

From the setup wizard, click Install GitHub App. You are redirected to GitHub to select org/account and repositories.
3

Grant repository access

Choose All repositories or select specific repos. You can adjust access later in GitHub Settings → Applications. If you select no repositories, LaneSync creates your workspace but the dashboard stays empty until you grant access and sync — you do not need to re-install the App.
4

Approve permissions

Review the requested permissions and click Install. LaneSync receives an installation webhook and creates or links your tenant.
5

Complete repo setup

For each new repository, run the repo setup wizard to configure branches, CI checks, and bootstrap sdlc.yaml plus workflows.

​
Wizard configuration

After installation, open the repo setup wizard for each repository. The wizard saves configuration before bootstrap runs. Additional wizard steps cover existing CI/deploy workflows and PR approval counts. LaneSync posts your choices to POST /api/repos/:repoId/config before bootstrap.
Example CI check names like CI — Build & Test are placeholders — use the exact job names from your repository’s workflows.

​
After install — two bootstrap paths

Requires: administration:write and workflows:write on the GitHub App.On the final wizard step, click Set up automatically. LaneSync calls POST /api/repos/:repoId/bootstrap using the App token, pushes files, creates rulesets, and marks the repository COMPLETE in one step.Best for teams that want hands-off branch protection and rulesets.

​
Bootstrap state progression

On minimal tier, LaneSync polls bootstrap status in the wizard until state reaches COMPLETE.

​
App tiers

Best for: Teams that want zero-touch branch protection and rulesets.LaneSync can enforce PR approvals and required checks without manual branch protection setup.

​
Required permissions

If rulesets are not created after bootstrap, verify the app has Administration: Read & Write (full tier) or use Retry branch protection setup in the setup wizard (minimal tier).

​
Adding repositories later

  1. GitHub → Settings → GitHub Apps → LaneSync → Configure
  2. Add repositories to the installation
  3. LaneSync discovers new repos on the next sync or via Discover repos in the dashboard
  4. Run the repo setup wizard for each new repository

​
Manual GitHub App setup (advanced)

Enterprise and self-hosted customers may register their own GitHub App and provide credentials via environment variables (GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY_PATH). See Enterprise self-hosting. For the hosted SaaS, use the setup wizard — manual setup is not required.

Trusted Bootstrap

PAT-based setup for the minimal App tier.

Configure sdlc.yaml

Customize gates after bootstrap.