Skip to main content
Connecting GitHub or GitLab is a one-time, organization-level action performed from Integrations — not from a per-repository “Repositories” section. Once your organization is connected, the Create Project wizard lists your repositories live from the provider’s API. There’s no manual repository import step to run beforehand. The two providers connect differently: GitHub installs the Chainloop GitHub App, while GitLab registers a connection with an access token.
1

Open Integrations

In the Chainloop web UI, go to Integrations. Under the source-control integrations you’ll find GitHub and GitLab.
The Integrations page with GitHub and GitLab source-control integrations
2

Connect the provider you use

Follow the provider-specific flow below.
Click Connect on the GitHub integration. GitHub prompts you to install the Chainloop GitHub App on your account or organization, then choose whether to grant access to all repositories or select individual ones.
GitHub App installation and authorization screen
You can change this selection later from GitHub without reconnecting from Chainloop.
Chainloop stores only repository metadata (ID and name), not your repository code.

​
Adjusting repository access

To change which repositories Chainloop can see, use the provider rather than reconnecting from Chainloop:
  • GitHub: open the Chainloop GitHub App configuration for your account or organization and update the repository selection. The Create Project wizard’s Manage access link takes you here.
  • GitLab: grant or revoke the access token’s membership on the relevant groups and projects (a token sees repositories at Developer level or above). To swap the token entirely, disconnect the connection from Integrations and register a new one.

​
Reconnecting

If a connection breaks, managed workflows and other repository features are paused for the affected repositories until you reconnect.
  • GitHub: if the App is uninstalled, go to Integrations, click Connect, and re-grant repository access.
  • GitLab: if the access token is revoked or expires, register the connection again from Integrations with a valid token.
Once connected, create a project and link a repository to it. See also the Repository Integration overview for how the providers differ and what connecting enables, and the GitHub permissions reference for the exact scopes the Chainloop GitHub App requests.