---
title: Collega GitHub
description: "Collega il tuo repository GitHub a Jamdesk per deploy automatici al push. Include installazione dell'app, selezione del repository e configurazione del branch."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Jamdesk si integra con GitHub per eseguire automaticamente il deploy della documentazione quando invii le modifiche.

Gli screenshot mostrano l'interfaccia in inglese.

<Note>
Per informazioni sul funzionamento congiunto dell'app GitHub e del collegamento dell'account personale, consulta [Informazioni sull'integrazione GitHub](/it/integrations/github).
</Note>

## Installazione dell'app GitHub

Quando accedi a Jamdesk per la prima volta, ti verrà chiesto di installare l'app GitHub di Jamdesk. Questa app consente di:

- **Accesso al repository** - Leggere i contenuti della documentazione
- **Webhook** - Attivare i build al push
- **Stato del commit** - Mostrare lo stato del build sui commit

### Autorizzazioni

L'app GitHub di Jamdesk richiede le seguenti autorizzazioni:

| Autorizzazione | Scopo |
|------------|---------|
| Contenuti del repository (lettura) | Clonare e leggere i file della documentazione |
| Metadati (lettura) | Elencare repository e branch |
| Webhook | Ricevere notifiche dei push |

<Note>
Jamdesk accede solo ai repository a cui concedi esplicitamente l'accesso. Puoi modificare l'accesso in qualsiasi momento nelle impostazioni di GitHub.
</Note>

## Collega un repository

<Steps>
  <Step title="Seleziona il repository">
    Quando crei o modifichi un progetto, fai clic su **Connect Repository**.

    Scegli tra i repository in cui è installata l'app GitHub.
  </Step>

  <Step title="Scegli il branch">
    Seleziona il branch da sottoporre a deploy:

    - **main** o **master** - I più comuni per la documentazione in produzione
    - **docs** - Se conservi la documentazione in un branch separato
    - Qualsiasi branch - Per i deploy di anteprima
  </Step>

  <Step title="Specifica il percorso della documentazione">
    Se il file `docs.json` non si trova nella directory principale del repository, specifica il percorso:

    ```bash
    docs/           # Docs in a subdirectory
    packages/docs/  # Monorepo with docs package
    ```

    Lascia vuoto se `docs.json` si trova nella directory principale.
  </Step>
</Steps>

Dopo il collegamento, il dashboard del progetto mostra il repository e il branch collegati:

<img src="/images/dashboard/github-connected.webp" alt="Dashboard che mostra un repository GitHub collegato con il badge di stato Linked, il nome del repository e il branch" style={{ display: 'block', margin: '0 auto', maxWidth: '500px' }} />

## Deploy automatici

Dopo il collegamento, ogni push al branch configurato attiva un build:

```bash
git add .
git commit -m "Update API documentation"
git push origin main
```

I build vengono generalmente completati in 30-90 secondi. Visualizza lo stato nel dashboard o sul commit GitHub.

## Cambiare repository

Per collegare un repository diverso:

1. Vai a **Settings** → **Repository**
2. Fai clic su **Change Repository**
3. Seleziona il nuovo repository e branch

<Warning>
La modifica dei repository può influire sulla documentazione attiva. Il nuovo repository deve contenere una configurazione Jamdesk valida.
</Warning>

## Gestire l'accesso all'app GitHub

Controlla a quali repository può accedere Jamdesk:

1. Vai a [github.com/settings/installations](https://github.com/settings/installations)
2. Trova **Jamdesk** nell'elenco
3. Fai clic su **Configure**
4. In "Repository access", seleziona repository specifici o tutti

### Repository dell'organizzazione

Per i repository dell'organizzazione, un amministratore dell'organizzazione deve approvare l'installazione dell'app GitHub:

1. Richiedi l'installazione dal dashboard di Jamdesk
2. Un amministratore riceve una notifica in GitHub
3. Dopo l'approvazione, i repository dell'organizzazione vengono visualizzati nel selettore dei repository

## Collega il tuo account personale

Per un'attribuzione affidabile dei build, collega il tuo account GitHub personale in **User Settings**:

1. Fai clic sul tuo avatar → **User Settings**
2. Trova la sezione **GitHub Account**
3. Fai clic su **Link GitHub Account**

Questa operazione è separata dall'app GitHub e garantisce che i tuoi commit vengano attribuiti correttamente a te. [Scopri di più](/it/integrations/github#account-github-personale-a-livello-di-utente).

## Risoluzione dei problemi

### Il repository non viene visualizzato

- Verifica che l'app GitHub sia installata nel repository
- Per i repository dell'organizzazione, verifica che un amministratore abbia approvato l'accesso
- Prova ad aggiornare l'elenco dei repository nel dashboard

### I build non si attivano

- Verifica che il webhook sia attivo nelle impostazioni del repository
- Verifica di eseguire il push al branch configurato
- Cerca gli errori di consegna dei webhook in GitHub

### Errori di autorizzazione negata

- Autorizza nuovamente l'app GitHub nelle impostazioni di GitHub
- Assicurati che il repository sia accessibile all'app Jamdesk

<Note>
  Per una risoluzione dei problemi più dettagliata, consulta [Informazioni sull'integrazione GitHub](/it/integrations/github).
</Note>

## Cosa fare ora?

<Columns cols={2}>
  <Card title="Crea un progetto" icon="plus" href="/it/setup/creating-projects">
    Configura un nuovo progetto Jamdesk
  </Card>
  <Card title="Struttura delle directory" icon="folder-tree" href="/it/setup/directory-structure">
    Organizza la documentazione per una crescita scalabile
  </Card>
</Columns>