> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing the Maia app in GitHub

export const maia_0 = undefined

export const designer = "Designer";

export const maia = "Maia";

<Info>
  This feature is available to customers on specific editions. Visit the {maia_0} [Pricing](https://www.maia.ai/pricing) page to learn more about each edition.
</Info>

Read [Prerequisites for connecting a GitHub repository to {maia}](/docs/guides/connect-github-repository-prerequisites) before installing the app.

***

## How to install the app

1. Log in to [GitHub](https://github.com/).
2. Navigate to the [{maia} Integration](https://github.com/marketplace/matillion-data-productivity-cloud-integration) app page.
3. Make sure you are about to install the app in your company's organization account and **not** your personal GitHub account, and then click **Install**.
4. Select **All repositories** or **Only select repositories**.
   * If you select **All repositories**, you can choose any current or new repos in your GitHub organization when you create a new project in {maia}.
   * If you select **Only select repositories**, choose the repository that you created for the sole purpose of developing your {designer} pipelines.

<Note>
  We recommend that you choose **Only select repositories** to allow access only to repositories that you intend to use with {maia}. If you select this option and then create new repositories in GitHub, you'll need to grant access to these new repositories if you want to connect them to {maia}. To do this, visit `https://github.com/organizations/<your-org-name>/settings/installations` (replacing "your-org-name" with your organization name) and click **Configure**. From this page, you can view the list of repositories that the {maia} GitHub app has access to. If no repositories are selected, create a repository in that organization first, and then create a [project](/docs/guides/projects) in {maia}.
</Note>

Once the {maia} app is installed in your organization's GitHub account, you can create your project in {designer} and connect your project to the GitHub repository.

***

## One-time installation

You only need to install the {maia} app in your GitHub organization account *once*. After this, whenever you create a new project in {maia}, you can connect to any repositories that you grant {maia} access to.

If you wish to revoke or change {designer}'s access to your repositories, go to `https://github.com/organizations/<your-org-name>/settings/installations` (change `<your-org-name>` to the organization in your GitHub URL) and click **Configure**.

***

## Required GitHub App permissions

When installing or using the {maia} app for GitHub, the following repository permissions are required:

* **Read and write access to contents**: Repository contents, commits, branches, downloads, releases, and merges.
* **Read and write access to Workflows**: GitHub Actions workflow files under `.github/workflows/`.

These permissions enable {maia} to commit changes, manage branches, and update GitHub Actions workflows in your repository.

<Note>
  If the GitHub App is already installed, GitHub will notify organization administrators to approve the additional Workflows permission. If this permission is not approved, the integration continues to function, but {maia} cannot modify GitHub Actions workflow files.
</Note>

***

## Related pages

* [Prerequisites](/docs/guides/connect-github-repository-prerequisites)
* [Troubleshooting GitHub repository connection](/docs/guides/troubleshooting-github-repository-connection)