Authenticate your Git provider

Last modified: October 8th, 2025

Permissions required

Members of the Owners or Developers Default Permission Groups, or Custom Permission Groups with the org:settings:git:provider permission, can manage which Git providers are connected to an Organization.

For CloudCannon to sync your files from a Git repository, you must give it permission to access your Git provider. CloudCannon supports GitHub, GitLab, or Bitbucket. You only need to authenticate your Git provider once, and you can authenticate multiple Git providers on an account (but not multiple accounts on the same provider).

There are two ways to authenticate a Git provider: when you create a new Site, and through your Org Settings page.

To authenticate a Git provider during Site creation:

  1. Click the Sites button in the App Sidebar. CloudCannon will open the Sites Browser.
  2. Click the Create a Site button. CloudCannon will open the Create a Site page.
  3. Select an unauthenticated Git provider using the File source dropdown. CloudCannon will show you the Authenticate button. Authenticated providers have a green shield icon next to the option.
  4. Click the Authenticate button and follow your Git provider's instructions to authenticate access.
  5. Return to the Create a Site page on CloudCannon and continue following the prompts to create a Site.

Your Git provider is now authenticated, and CloudCannon will display all repositories available through that provider in the Repository dropdown.

A screenshot of the Create a Site page shows an Authenticate button to approve CloudCannon's access to GitHub.
A screenshot of the list of Git providers shows the green shield icon indicating that Git Hub is authenticated through CloudCannon.

To authenticate a Git provider through your Org Settings:

  1. Click the Org Settings button in the App Sidebar. CloudCannon will open the Details page.
  2. Navigate to the GitHub, Bitbucket, or GitLab page under the Files heading, depending on which provider you want to authenticate.
  3. Click the Authenticate button and follow your Git provider's instructions to authenticate access.

Your Git provider is now authenticated.

A screenshot of the Bitbucket page under Org Settings shows the authenticate button.

Open in a new tab