---
url: /manage-git-integrations.md
description: >-
  Connect GitHub and GitLab accounts to your user or organization to import
  repositories and enable automatic builds on the Kipu Quantum Hub.
---

# Manage Git Integrations

Git integrations connect your Kipu Quantum Hub account or organization to GitHub and GitLab so you can import repositories and enable automatic builds, e.g., for [Demos](usecases/demos/deploy-demo).

You can manage Git integrations in \[User Icon] → `Settings` → `Git Integrations`.

::: tip NOTE
Adding a Git integration to an organization requires the `Maintainer` role in that organization on the platform.
See [Manage Organizations](manage-organizations) for details on roles.
:::

Access tokens used by Git integrations are stored securely and encrypted.
Token values are never visible in plain text after they are saved.

## GitHub

Connecting a GitHub account installs the Kipu Quantum Hub GitHub App on a GitHub user account or organization.
The GitHub App grants the platform access to the repositories you select during installation.

**To connect a GitHub account**, open the Git Integrations page and click **Connect GitHub Account**.
You will be redirected to GitHub to authorize the GitHub App and choose which repositories the platform can access.

### Required GitHub permissions

* To install the GitHub App on a **personal GitHub account**, you must be the owner of that account.
* To install the GitHub App on a **GitHub organization**, you must have the `Owner` role in that GitHub organization.
  If you don't have owner rights, you can request access — a GitHub organization admin can then approve the installation on your behalf.

### Add by installation ID

If the GitHub App has already been installed on a GitHub account or organization (for example by an admin), you can attach the existing installation to your account or organization on the platform via the **Add by installation ID** link on the Git Integrations page.

## GitLab

The GitLab integration uses a [GitLab personal access token](https://docs.gitlab.com/user/profile/personal_access_tokens/) to access your GitLab repositories.

**To add a GitLab token**, open the Git Integrations page and click **Add GitLab Token**, then paste a personal access token from GitLab.

### Required GitLab token scopes

* **`api` (required)**: Needed so the platform can read repositories and import them.
* **Maintainer access on the repository (required)**: Needed so the platform can **auto-configure automatic rebuilds** of a Demo when you push to the repository.