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

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

How to connect and update your GitHub Organization with your Tenki Workspace.



The connection between your GitHub Organization and your Tenki workspace is managed through the Tenki 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 Tenki GitHub App during the onboarding [#1-install-the-tenki-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.

![GitHubApplicationInstall](https://tenki.cloud/images/get-started/connect-github.png)

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

![TenkiGithubInstall2](https://tenki.cloud/images/get-started/install-github.png)

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

> **Important:** A Tenki Workspace can be connected to only one GitHub Organization and vice-versa.

2. Install the Tenki GitHub App manually [#2-install-the-tenki-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 and Project [#select-your-workspace-and-project]

Verify that you’ve selected the correct workspace, then select your project.

![ManualGitHubApplicationInstallationStep1](https://tenki.cloud/images/get-started/manual-gh-install-step1.png)

**Step 2:**
Access the Organization tab [#access-the-organization-tab]

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

![ManualGitHubApplicationInstallationStep2](https://tenki.cloud/images/get-started/manual-gh-install-step2.png)

**Step 3:**
Application installation [#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 Tenki 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:

![ManualGitHubApplicationInstallationStep4](https://tenki.cloud/images/get-started/manual-gh-install-step4.png)

Select your GitHub user:

![ManualGitHubApplicationInstallationStep5](https://tenki.cloud/images/get-started/manual-gh-install-step5.png)

Select your GitHub Organization:

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

![ManualGitHubApplicationInstallationStep6](https://tenki.cloud/images/get-started/manual-gh-install-step6.png)

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

![ManualGitHubApplicationInstallationStep7](https://tenki.cloud/images/get-started/manual-gh-install-step7.png)

**Step 4:**
Verify the connection [#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.

![ManualGitHubApplicationInstallationStep8](https://tenki.cloud/images/get-started/manual-gh-install-step8.png)

![GH-app-manual-install](https://tenki.cloud/images/get-started/manual-gh-install-step4.png)

3. When you're not owner of the GitHub Organization [#3-when-youre-not-owner-of-the-github-organization]

When you try to install the Tenki 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 [#maintainupdate-the-connection]

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

![GitHubApplicationMaintenance1](https://tenki.cloud/images/get-started/gh-link-maintenance-1.png)

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

![GitHubApplicationMaintenance2](https://tenki.cloud/images/get-started/gh-link-maintenance-2.png)

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