---
title: Conectar GitHub
description: "Conecta tu repositorio de GitHub a Jamdesk para despliegues automáticos en cada push. Cubre instalación de la app, selección de repositorio y rama."
---

Jamdesk se integra con GitHub para desplegar automáticamente tu documentación cuando haces push con cambios.

Las capturas de pantalla muestran la interfaz en inglés.

<Note>
Para más información sobre cómo funcionan juntos la GitHub App y el enlace de cuenta personal, consulta [Comprender la integración con GitHub](/es/integrations/github).
</Note>

## Instalación de la GitHub App

Cuando inicias sesión en Jamdesk por primera vez, se te pedirá que instales la Jamdesk GitHub App. Esta app permite:

- **Acceso al repositorio** - Leer el contenido de tu documentación
- **Webhooks** - Activar builds en cada push
- **Estado del commit** - Mostrar el estado del build en los commits

### Permisos

La Jamdesk GitHub App solicita estos permisos:

| Permiso | Propósito |
|------------|---------|
| Contenido del repositorio (lectura) | Clonar y leer tus archivos de documentación |
| Metadatos (lectura) | Listar repositorios y ramas |
| Webhooks | Recibir notificaciones de push |

<Note>
Jamdesk solo accede a los repositorios a los que explícitamente le otorgas acceso. Puedes modificar el acceso en cualquier momento en tu configuración de GitHub.
</Note>

## Conectar un repositorio

<Steps>
  <Step title="Seleccionar repositorio">
    Al crear o editar un proyecto, haz clic en **Conectar repositorio**.

    Elige entre los repositorios donde la GitHub App está instalada.
  </Step>

  <Step title="Elegir rama">
    Selecciona la rama a desplegar:

    - **main** o **master** - La más común para documentación en producción
    - **docs** - Si mantienes la documentación en una rama separada
    - Cualquier rama - Para despliegues de preview
  </Step>

  <Step title="Especificar la ruta de la documentación">
    Si tu `docs.json` no está en la raíz del repositorio, especifica la ruta:

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

    Déjalo en blanco si `docs.json` está en la raíz.
  </Step>
</Steps>

Una vez conectado, el dashboard de tu proyecto muestra el repositorio y la rama vinculados:

<img src="/images/dashboard/github-connected.webp" alt="Dashboard showing GitHub repository connected with Linked status badge, repository name, and branch" style={{ display: 'block', margin: '0 auto', maxWidth: '500px' }} />

## Despliegues automáticos

Una vez conectado, cada push a tu rama configurada activa un build:

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

Los builds suelen completarse en 30-90 segundos. Consulta el estado en el dashboard o en el commit de GitHub.

## Cambiar de repositorio

Para conectar un repositorio diferente:

1. Ve a **Configuración** → **Repositorio**
2. Haz clic en **Cambiar repositorio**
3. Selecciona el nuevo repositorio y la rama

<Warning>
Cambiar de repositorio puede afectar tu documentación en producción. El nuevo repositorio debe contener una configuración válida de Jamdesk.
</Warning>

## Gestionar el acceso a la GitHub App

Controla a qué repositorios puede acceder Jamdesk:

1. Ve a [github.com/settings/installations](https://github.com/settings/installations)
2. Encuentra **Jamdesk** en la lista
3. Haz clic en **Configurar**
4. En "Acceso al repositorio", selecciona repositorios específicos o todos

### Repositorios de organizaciones

Para repositorios de organizaciones, un administrador de la organización debe aprobar la instalación de la GitHub App:

1. Solicita la instalación desde tu dashboard de Jamdesk
2. Un administrador recibe una notificación en GitHub
3. Una vez aprobado, los repositorios de la organización aparecen en el selector de repositorios

## Vincular tu cuenta personal

Para una atribución de builds confiable, vincula tu cuenta personal de GitHub en **Configuración de usuario**:

1. Haz clic en tu avatar → **Configuración de usuario**
2. Busca la sección **Cuenta de GitHub**
3. Haz clic en **Vincular cuenta de GitHub**

Esto es independiente de la GitHub App y garantiza que tus commits te sean correctamente atribuidos. [Más información](/es/integrations/github#cuenta-personal-de-github-nivel-de-usuario).

## Solución de problemas

### El repositorio no aparece

- Verifica que la GitHub App esté instalada en el repositorio
- Para repositorios de organizaciones, confirma que un administrador haya aprobado el acceso
- Intenta actualizar la lista de repositorios en el dashboard

### Los builds no se activan

- Comprueba que el webhook esté activo en la configuración del repositorio
- Verifica que estés haciendo push a la rama configurada
- Busca errores en la entrega de webhooks en GitHub

### Errores de permiso denegado

- Vuelve a autorizar la GitHub App en tu configuración de GitHub
- Asegúrate de que el repositorio sea accesible para la Jamdesk App

<Note>
  Para una solución de problemas más detallada, consulta [Comprender la integración con GitHub](/es/integrations/github).
</Note>

## ¿Qué sigue?

<Columns cols={2}>
  <Card title="Crear un proyecto" icon="plus" href="/es/setup/creating-projects">
    Configura un nuevo proyecto de Jamdesk
  </Card>
  <Card title="Estructura de directorios" icon="folder-tree" href="/es/setup/directory-structure">
    Organiza tu documentación para escalar
  </Card>
</Columns>