# Connect your GitHub Organization (https://luxor.ai/docs/github/gh-organization)

> For the complete documentation index, see [llms.txt](https://luxor.ai/llms.txt)

How to connect and update your GitHub Organization with your Luxor Agent Cloud workspace.

The connection between your GitHub Organization and your Luxor Agent Cloud workspace is managed through the Luxor Agent Cloud GitHub Application, which is responsible for creating and maintaining the link between both systems. You can install it using one of the following two methods:

## 1. Install the Luxor Agent Cloud GitHub App during the onboarding

During new account onboarding, we walk you through each step, including installing the GitHub application. From here, click Connect GitHub to continue.

<img src="getAsset(&#x22;/images/get-started/connect-github.png&#x22;)" alt="GitHubApplicationInstall" />

Then select the level of permissions you want to grant the application and click on Install & Authorize:

<img src="getAsset(&#x22;/images/get-started/install-github.png&#x22;)" alt="TenkiGithubInstall2" />

[Video](https://storage.googleapis.com/tenki-cloud-assets/docs/tenki_step2_install_gh_app.mp4)

> **Important:** A workspace can be connected to only one GitHub organization, and vice versa.

## 2. Install the Luxor Agent Cloud GitHub App manually

If you don't want to use the automatic onboard or prefer to install the application on your own you need to do it as below:

**Step 1:**
### Select your Workspace

Verify that you’ve selected the correct workspace.

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step1.png&#x22;)" alt="ManualGitHubApplicationInstallationStep1" />

**Step 2:**
### Access the Organization tab

Now within the Runners section click on the Organization tab and then click on the Connect GitHub button

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step2.png&#x22;)" alt="ManualGitHubApplicationInstallationStep2" />

**Step 3:**
### Application installation

You’ll see a modal displaying all your workspaces and the GitHub Organizations they are linked to. This helps ensure a unique connection, as each GitHub Organization can be connected to only one workspace.

Below is an example of how this looks after you’ve created a second workspace. If you only have one workspace, the Other workspaces you have access to section will be empty.

You can click on continue:

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step4.png&#x22;)" alt="ManualGitHubApplicationInstallationStep4" />

Select your GitHub user:

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step5.png&#x22;)" alt="ManualGitHubApplicationInstallationStep5" />

Select your GitHub Organization:

> **Info:** If you see Configure, it means the Luxor Agent Cloud GitHub Application is already installed.

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step6.png&#x22;)" alt="ManualGitHubApplicationInstallationStep6" />

Select the level of access you want to provide and click on Install & Authorize:

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step7.png&#x22;)" alt="ManualGitHubApplicationInstallationStep7" />

**Step 4:**
### Verify the connection

After installation and authorization, simply verify that everything is set up correctly. Then navigate back to the Organization tab, where you should see your GitHub Organization successfully connected.

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step8.png&#x22;)" alt="ManualGitHubApplicationInstallationStep8" />

<img src="getAsset(&#x22;/images/get-started/manual-gh-install-step4.png&#x22;)" alt="GH-app-manual-install" />

## 3. When you're not owner of the GitHub Organization

When you try to install the Luxor Agent Cloud GitHub Application on an organization where you’re not an owner, the process is slightly different. Instead of installing the application directly, you submit a request for installation.

You’ll be prompted to confirm the request, after which the organization owners will be notified. They can review and approve the installation from the GitHub UI. Once an administrator approves the request, the installation is completed and the connection proceeds automatically.

## Maintain/Update the connection

Whenever you need to review access levels or add or remove repositories, go to the Organization tab and click Configure Connection:

<img src="getAsset(&#x22;/images/get-started/gh-link-maintenance-1.png&#x22;)" alt="GitHubApplicationMaintenance1" />

You’ll be redirected to the GitHub interface, where you can manage which repositories the application has access to:

<img src="getAsset(&#x22;/images/get-started/gh-link-maintenance-2.png&#x22;)" alt="GitHubApplicationMaintenance2" />

> **Note:** The next section provides more details on linking and managing your repositories in your workspace.