Skip to content

Repositories

Repository states, and what connect, disconnect, reconnect and archive each mean.

Repository statesPermalink to Repository states

Every connected repository is in exactly one of four states. Only Active repositories can be scanned; the console shows the reason and the next step for the others.

StateWhat it meansCan it be scanned?
ActiveRelane Security can read the repository and it is eligible for scanning.Yes
Access suspendedThe GitHub App installation is suspended, so the repository cannot be read.No — restore access from GitHub
DisconnectedAccess is no longer granted for this repository.No — reconnect it to resume scanning
ArchivedThe repository was removed from scanning.No — re-add it to scan
The four repository states.

Disconnect, reconnect and archivePermalink to Disconnect, reconnect and archive

Disconnecting a repository stops it being scanned and leaves its previous scans and findings readable. Reconnecting it restores eligibility; you do not lose scan history by disconnecting.

Archiving removes a repository from scanning. Its history remains, and re-adding the repository is what brings it back.

History survives a disconnect

Scans that already completed keep their results. Changing a repository connection affects what can be scanned next, not what was scanned before.

Why a repository cannot be scannedPermalink to Why a repository cannot be scanned

The scan button is unavailable for any repository that is not Active, and the console states the reason. The server enforces the same rule, so a scan cannot be started against an ineligible repository even if the page is stale.

ReasonWhat to do
DisconnectedThis repository was disconnected. Reconnect it to resume scanning.
ArchivedThis repository was removed from scanning. Re-add it to scan.
Access suspendedThe GitHub App installation is suspended. Restore access to scan.
UnavailableThis repository is not available for scanning right now.
Ineligibility reasons and their remedies.