---
title: GitHub Account Linking
description: Link your personal GitHub account for build attribution and private repo access. Separate from the GitHub App your project uses.
---

Linking your GitHub account connects your identity for build attribution and enables access to private repositories.

## Why Link GitHub?

Linking your GitHub account lets you:

- Connect private repositories to Jamdesk
- Enable automatic builds on push
- Access repositories from organizations you belong to

## Linking Your Account

<Steps>
  <Step title="Go to Settings">
    Click your avatar and select **Settings**.
  </Step>
  <Step title="Select Connections">
    Navigate to the **Connections** tab.
  </Step>
  <Step title="Click Connect GitHub">
    Select **Connect GitHub Account**.
  </Step>
  <Step title="Authorize Jamdesk">
    Review the permissions and click **Authorize** in GitHub.
  </Step>
</Steps>

## Permissions Requested

Jamdesk requests minimal permissions:

| Permission | Purpose |
|------------|---------|
| Read repository contents | Access your documentation files |
| Read repository metadata | List your repositories |
| Webhooks | Receive push notifications for automatic builds |

<Note>
Jamdesk never writes to your repositories. All access is read-only.
</Note>

## Unlinking Your Account

To disconnect GitHub:

1. Go to **Settings** → **Connections**
2. Click **Disconnect** next to GitHub
3. Confirm the disconnection

<Warning>
Disconnecting GitHub will disable automatic builds for all your projects. You'll need to reconnect to re-enable them.
</Warning>

## Organization Repositories

To access repositories from a GitHub organization:

1. Go to the organization's settings on GitHub
2. Navigate to **Third-party access** → **OAuth Apps**
3. Find Jamdesk and click **Grant** access

If you don't see this option, ask an organization admin to approve Jamdesk.

## Related Articles

<Columns cols={2}>
  <Card title="Connecting GitHub" icon="github" href="/setup/connecting-github">
    Connect a repository to a project
  </Card>
  <Card title="GitHub Issues" icon="circle-exclamation" href="/help/troubleshooting/github-issues">
    Troubleshoot GitHub connection problems
  </Card>
</Columns>