TroubleshootingThe code scan could not read your private repo. Work through the ranked causes below to grant access.
Troubleshooting · Troubleshooting
Private repo permission errors
The code scan could not read your private repo. Work through the ranked causes below to grant access.
Reviewed by Security·Updated May 28, 2026·2 min readSuggest edit
Does this match what you’re seeing?
REPOThe scan reports a permissions error and the code scan is skippedmost common
REPOYour repo doesn't appear in the picker even though the GitHub App is installedsee below
A blocked code scan is almost always a missing or under-scoped grant — not a
bug in Wolfix. Access is always read-only, so widening it carries no risk to
your code. Work through the three causes below from most to least common.
01
Wolfix lacks access to the organisation's repos
The repository belongs to an organisation and the GitHub App install was never approved by an owner, so Wolfix can see your account but not the org's repos.
48%
of cases
How to fix
Security
A member can request the GitHub App install, but for an organisation-owned repo
an owner has to approve it before Wolfix can read any contents. Until that
approval lands, the repo won't show up in the picker.
To grant access:
Ask an organisation owner to open Settings → Third-party Access → GitHub
Apps and approve the Wolfix install request.
In the install settings, confirm the specific repo is shared — choose Only
select repositories and add it if it's missing.
Re-run the scan. The repo now appears in Wolfix's picker and the code scan
proceeds.
02
The grant needs SSO authorization
The organisation enforces SAML single sign-on, and the install or token was never authorized for SSO — so it reads as valid but returns nothing.
34%
of cases
How to fix
Security
Organisations with SAML SSO require every grant to be authorized for SSO
before it can read repository contents. A grant that skips this step looks
complete but still returns a permissions error during the scan.
To authorize:
Open your organisation's settings and find the Wolfix GitHub App (or your
fine-grained token).
Click Configure SSO and authorize the grant for the organisation that
owns the repo.
Re-run the scan. With SSO cleared, the code scan can read the default branch.
03
The fine-grained PAT is under-scoped
A fine-grained personal access token is missing the read-only Contents permission, or it points at the wrong resource owner or repo.
18%
of cases
How to fix
Security
When you use a fine-grained PAT instead of the GitHub App, the only permission
Wolfix needs is Contents: read-only — but the token also has to target the
right owner and repository.
To fix the token:
At GitHub → Settings → Developer settings → Fine-grained tokens, open the
token and set Resource owner to the organisation (or user) that owns the
repo.
Under Repository access, choose Only select repositories and add the
one repo you're scanning.
Under Permissions → Repository permissions, set Contents to
Read-only. Save, then Configure SSO if your org requires it.
Paste the refreshed token into Wolfix's Connect screen and re-run the scan.
None of those?
Open a ticket with your scan ID attached.
Find your scan ID on the Report page — it looks like scan_4087. Include it in your ticket so the team can pull the exact trace.