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

# GitHub

> Install the Ryvn GitHub App and choose which repositories Ryvn can access

Connect GitHub to build services from repositories and use [infrastructure as code](/docs/configure/infrastructure-as-code). Ryvn uses a GitHub App installation for repository access.

GitHub App installation and repository access are configured through the dashboard and GitHub. The CLI does not provide commands to install the app or change its repository permissions.

## Configure the connection

<Steps>
  <Step title="Start the installation">
    Open **Settings > Connections > GitHub** and click **Install GitHub App**.
  </Step>

  <Step title="Choose an account and repositories">
    In GitHub, select the account or organization that owns your repositories. Review the app's requested permissions and select the repositories Ryvn should access. Complete the installation or request approval from a GitHub organization administrator.
  </Step>

  <Step title="Verify in Ryvn">
    Return to **Settings > Connections > GitHub** and check that the account appears. You can now [create a service from a GitHub repository](/docs/deploy/deploy-from-github) or configure a Git sync repository.
  </Step>
</Steps>

## Change repository access

Use the settings control beside the connected account to open the GitHub App's installation settings. Add or remove repository access there.

If a repository is missing in Ryvn, confirm the app is installed on its owning account and that the repository is included in the installation's allowed repositories. Check whether your GitHub organization still needs to approve the installation.

## Disconnect an account

Use the disconnect control beside the account and review the confirmation before continuing. Builds and Git sync that depend on this connection need working repository access. Check those consumers before disconnecting.