On this page

GitHub Integration

Guara Cloud connects to GitHub in two different ways, each with a specific purpose.

Two types of connection

1. GitHub OAuth (login)

This is the connection used for authentication. When you log in with GitHub, Guara Cloud identifies who you are. This connection only accesses your basic profile (name, email, and avatar).

2. GitHub App (repository access)

This is the connection used to access your repositories. The Guara Cloud GitHub App reads the code from your repos to build and deploy your applications. You control exactly which repositories the app can access.

Installing the GitHub App

To connect your repositories to Guara Cloud:

  1. Create a service and choose GitHub as the code source.
  2. Authorize the installation of the Guara Cloud GitHub App on your account or organization.
  3. Select which repositories you want to grant access to.
  4. The app will be able to read your code to build and deploy.

Managing installations

After installing the GitHub App, you can follow your linked accounts under Settings, in the Integrations tab:

  • Under Linked accounts, see each personal GitHub account or organization where the app is installed.
  • To use repositories from another organization, click Add organization and install the app there. You can link several organizations to the same Guara Cloud account.
  • To change which repositories the app can access, click Manage on GitHub. You’ll be taken to the GitHub App settings, where you can add or remove repositories.

Revoking access

To disconnect Guara Cloud from your repositories, remove the app on GitHub: under Settings > Applications > Installed GitHub Apps (or in the organization’s settings), uninstall Guara Cloud or remove the repositories you no longer want to share.

Without access, services that depend on those repositories can’t deploy again until the connection is restored.