Choose your preferred SSG:
Choose your preferred SSG:

Connecting a GitHub respository as your source

Connecting GitHub allows you to work on your websites locally and have the changes sync to CloudCannon. File changes made on CloudCannon are also synced back to GitHub.

To connect a GitHub repository and start syncing files, follow these instructions:

  1. Go to Site Settings / Source Syncing 
  2. Select GitHub repository 
  3. Click Authenticate
Selecting GitHub as your source provider

This redirects you to GitHub. Enter your credentials to continue.

GitHub authentication screen

Give CloudCannon access to your GitHub Account by clicking Authorize application. You can also Grant Access to any GitHub Organizations you wish to use in CloudCannon.

GitHub connection screen

You’ll be redirected back to CloudCannon to pick a repository to connect. If you don’t have one for this website, create a new one in GitHub and refresh this page.

Selecting your GitHub repository to sync

Any existing files on your website will be replaced with the contents of the selected repository. Click Backup and Sync to continue, or exit the page to cancel the process.

GitHub is now connected. Changes you push to the Git repository are pulled in by CloudCannon. Any changes made on CloudCannon are automatically committed and pushed.

Adding a new GitHub Organization

GitHub Organizations do not provide access to third parties applications. You’ll need to manually allow access to sync GitHub Organization repositories with CloudCannon.

To allow access, open the settings for the Organization on GitHub and go to the Third-party access tab. Click on your own authorized applications under the No pending requests header.

GitHub Organization Settings

Click the Edit button next to CloudCannon.

GitHub Organization Settings

Click Grant Access. You will now be able to sync repositories owned by the GitHub Organization in CloudCannon.

Was this article helpful? or Suggest an improvement >

Related articles