Getting Started

Configure a Code Management Tool

Set Up GitHub

Connect GitHub via OAuth or token:

OAuth (Recommended): Click the “via OAuth” button. You’ll be redirected to GitHub’s authentication page.
- ✅ Fossy appears as a dedicated bot in PRs
- ✅ Better audit trail (clear distinction between human and AI reviews)
- Requires owner permissions for your organization
- Grant access to all repositories you want Fossy to analyze (you can adjust this later)
Token: Reviews appear under your username. Visit the GitHub Token Setup page for detailed instructions.

Using GitHub Enterprise? Allowlist Fossa’s IP 52.55.217.197 in your network firewall before connecting.

Set Up GitLab

Connect GitLab via OAuth or token:

OAuth (Recommended): Click the “via OAuth” button, and you’ll be redirected to GitLab’s authentication page.
- ✅ Fossy appears as a dedicated bot in PRs
- Grant access to all repositories you want Fossy to analyze (you can adjust this later)
Token: Reviews appear under your username. Visit the GitLab Token Setup page for detailed instructions.

Using a self-hosted GitLab instance? Allowlist Fossa’s IP 52.55.217.197 in your network firewall before connecting.

Set Up Bitbucket

Connect Bitbucket via OAuth or token:

Using Bitbucket Data Center (self-hosted)? Allowlist Fossa’s IP 52.55.217.197 in your network firewall before connecting.

Set Up Azure DevOps

Connect Azure DevOps via OAuth or token:

Using Azure DevOps Server (self-hosted)? Allowlist Fossa’s IP 52.55.217.197 in your network firewall before connecting.

Set Up Forgejo

Connect Forgejo via token:

Forgejo support is maintained by the community.

Next Steps