Contact support

Tell us what you were trying to do and what happened. We reply by email.

Get started
Set up your team

Add repositories

Choose which GitHub repositories Lighthouse tracks.

Adding a repository tells Lighthouse to track it: learn its security rules, scan its pull requests, and accept pre-commit scans from developers. You can add any repository your GitHub connection can see.

Who can do this:Team admins

Add one repository

Go to Repositories and press New repository.

Pick the repository. Lighthouse fills in three fields, which you can change:

FieldMeaning
NameHow the repository is shown in Lighthouse.
Repository URLWhere the code lives on GitHub.
Default branchThe main line of the repository, usually main. Taken from GitHub.

Press Create repository.

Add several at once

Open Lighthouse Setup and press Add repositories. Select every repository you want and confirm. Each one gets its GitHub name and default branch.

After you add a repository

  • Its status is Not started until its first ingestion finishes. Run one now so enhancement and scans have its rules.
  • Its pull requests are scanned right away, using your team defaults.
  • Developers run reware-lighthouse init in their checkout to get pre-commit scans. The repository page shows the exact commands under Connect this repository.

Delete a repository

On Repositories, press the delete button at the end of the repository's row. This removes the repository and its history from Lighthouse. Nothing changes on GitHub.

You can't delete a repository while an ingestion or scan is running on it.

Troubleshooting

You seeDo this
Connect a Git providerYour team hasn't connected GitHub yet. Connect GitHub.
The repository isn't listedGive the GitHub App access to it, then press Sync in Settings › Git providers.
We couldn't load the branch list. The default branch is selected.GitHub didn't respond in time. Create the repository anyway, or try again in a minute.
Still stuck after reading this page?

Contact support

Tell us what you were trying to do and what happened. We reply by email.

On this page