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

# GitHub

> How to connect Aixs with GitHub to run private repositories

To run a private repository with Aixs, you need to connect your GitHub account from the Dashboard settings.

## Steps

### 1. Open Settings

Navigate to **Settings** in the Dashboard sidebar.

### 2. Go to GitHub Integration

Select **GitHub Integration** (**GitHub連携**) from the settings menu.

<img src="https://mintcdn.com/aixs/KIcyjiZ7QpqCcdVw/images/github-integration.png?fit=max&auto=format&n=KIcyjiZ7QpqCcdVw&q=85&s=6ade7647c61d297ac50cf447c4d820b1" alt="GitHub integration settings" width="748" height="310" data-path="images/github-integration.png" />

### 3. Connect GitHub

Click **Connect GitHub** (**GitHub連携をする**) to start the authorization flow.

Your browser will open GitHub's authorization page — review the requested permissions and click **Authorize** to complete the connection.

Once connected, Aixs can access your private repositories and trigger deployments automatically.

## OAuth vs. the Aixs GitHub App

These are two separate access paths, and which one you need depends on who owns the repository.

|                                 | Aixs GitHub App              | GitHub OAuth                    |
| ------------------------------- | ---------------------------- | ------------------------------- |
| Best for                        | Organization repositories    | Repositories you own personally |
| Shared with your team           | Yes — bound to the workspace | No — tied to your own account   |
| Needs periodic re-authorization | No                           | Yes                             |

**Install the Aixs GitHub App for organization repositories.** The App mints short-lived access tokens from its own credentials, so it keeps working regardless of any individual member's connection state, and your teammates do not each need to connect their own account.

OAuth is the fallback for repositories the App does not cover — typically repositories you own personally.

## Re-connecting

GitHub access tokens issued through OAuth expire. Aixs renews them automatically in the background, so you normally never notice.

If the renewal itself becomes impossible — for example you revoked the authorization on GitHub, or the connection sat unused past its refresh window — the GitHub Integration section shows **Re-authentication required** (**要再連携**). Click **Re-connect** (**再連携する**) there to restore access. You do not need to disconnect first.

Repositories accessed through the Aixs GitHub App are unaffected by this.