Troubleshooting GitHub integration

Resolve common GitHub setup, permissions, and scanning issues.

Common issues:

  • Installation suspended: restore the GitHub App installation
  • Missing permissions: update installation permissions and reconcile
  • Repository inaccessible: re-add repository access in GitHub and reconcile
  • Missing `.fooguard.yml`: add a valid root config file
  • No scans on push: verify webhook delivery and enabled repository status

See also the Help & FAQ page for task-oriented answers.

Related pages