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 view connected repositories at any time:

  1. Go to Settings in the user menu.
  2. Click on GitHub Integration.
  3. See the list of connected repositories and their permissions.

To add new repositories, click Manage on GitHub. You will be redirected to the GitHub App settings on your account, where you can change which repos are accessible.

Revoking access

If you want to disconnect Guara Cloud from your repositories:

  1. Go to Settings > GitHub Integration.
  2. Click Disconnect.
  3. Confirm the revocation.

When you disconnect, Guara Cloud will lose access to your repositories. Services that depend on those repos will not be able to perform new deployments until the connection is re-established.

You can also revoke access directly on GitHub by going to Settings > Applications > Installed GitHub Apps and removing Guara Cloud.