> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar GitHub Codespace

La forma más sencilla de probar Ayakaleaf Pro es usar GitHub Codespace, donde todas las variables de entorno están preconfiguradas para que puedas usarlo nada más empezar.

<Warning>
  Cuando ejecutas contenedores de Docker con GitHub Codespaces, el Codespace no se apagará automáticamente y se te seguirá **facturando**. Para conocer las reglas de facturación de GitHub Codespaces, consulta las [reglas de facturación de GitHub Codespaces](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

  Para gestionar tus GitHub Codespaces, visita [https://github.com/codespaces](https://github.com/codespaces). Cuando ya no lo necesites, elimina tu Codespace a tiempo.
</Warning>

Hemos **preconfigurado** las siguientes funciones:

* [x] Compilación de LaTeX en sandbox con TeXLive **Basic** (2024-2026)
* [x] Importación/exportación con Pandoc (funciones de la plataforma SaaS)
* [x] Ejecutor de scripts de Python (funciones de la plataforma SaaS)
* [x] Compatibilidad con Git-Bridge (funciones de Server Pro)
* [x] Búsqueda avanzada de referencias (funciones de la plataforma SaaS)
* [x] Panel de administración (gestión global de usuarios y proyectos)
* [x] Control de cambios (con panel de revisión y comentarios)
* [x] Historial completo del proyecto (con restauración y descarga)
* [x] Paleta de símbolos (funciones de Server Pro/plataforma SaaS)

<Warning>
  Los GitHub Codespaces estándar ofrecen 32 GB de almacenamiento. Esto es insuficiente para nuestra instalación de `texlive-full`. Para probar la imagen completa, envía una solicitud de soporte a GitHub para obtener un Codespace con runners grandes (8 núcleos o más).
</Warning>

La sincronización con GitHub, LDAP, OAuth, SSO, la integración con Zotero y otras funciones ***no están configuradas*** en este entorno de pruebas. Puedes consultar la [configuración del Toolkit](/es/on-premises/configuration/overleaf-toolkit/toolkit-settings) para obtener más detalles sobre cómo configurar estas funciones en tu propio despliegue.

<Steps>
  <Step title="Crear tu GitHub Codespace">
    Haz clic en el siguiente botón para crear tu GitHub Codespace. En cuanto a la configuración del servidor, **2 núcleos con 8 GB de RAM** suelen ser suficientes para una prueba. Si piensas usar [**TeX Live Full**](https://github.com/ayaka-notes/texlive-full), te recomendamos elegir una configuración de **8 núcleos y 64 GB**.

    [![Abrir en GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ayaka-notes/ayakaleaf-pro-playground)
  </Step>

  <Step title="Inicializar la instancia de Overleaf">
    Cuando tu codespace esté listo, ejecuta el siguiente comando en tu terminal bash para inicializar tu instancia de Overleaf.

    ```bash title="bash" theme={null}
    ./init.sh
    ```

    <Info>
      Es posible que tengas que esperar al menos 3 minutos hasta que se descarguen todas las imágenes de Docker necesarias.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-26.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=8566b61de0757c1b270e7e5011d48a3e" alt="" width="1181" height="626" data-path="images/on-premises/image-26.png" />
    </Frame>
  </Step>

  <Step title="Hacer público el puerto 80">
    Cambia a la pestaña **Ports** y sigue estos pasos para hacer público el puerto 80.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/img-db37d3e4.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=81e5a18f3aebbd396a57d163a2460739" alt="" width="1452" height="694" data-path="images/on-premises/img-db37d3e4.png" />
    </Frame>

    Después, puedes hacer clic en **Forwarded Address** para visitar tu instancia de Overleaf. Es posible que tengas que añadir `/launchpad` para acceder a la página de bienvenida de Overleaf.
  </Step>

  <Step title="Crear tu cuenta de administrador">
    Introduce la cuenta y la contraseña de administrador y haz clic en el botón Register.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-1ae40ae0.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=82d769561891fd4b4566ee2ad9c48065" alt="" width="2736" height="1798" data-path="images/on-premises/img-1ae40ae0.png" />
    </Frame>
  </Step>

  <Step title="Disfruta escribiendo">
    ¡Ahora ya puedes disfrutar escribiendo en $\LaTeX$!

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-25.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=1d4e1fac863cbee906d9d3ad2f3c08d7" alt="" width="2104" height="1415" data-path="images/on-premises/image-25.png" />
    </Frame>
  </Step>
</Steps>

#### Usar la imagen TeXLive Full

Si tienes acceso a GitHub Codespaces de 8 núcleos y 64 GB, puedes usar la imagen TeXLive Full en este entorno de pruebas. Puedes cambiar las siguientes variables de entorno en el archivo `toolkit/config/variables.env` para usar la imagen TeXLive Full en lugar de la imagen TeXLive Basic.

```dotenv wrap theme={null}
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
```

Después de cambiar las variables de entorno, debes reiniciar el Toolkit para aplicar los cambios. Puedes ejecutar el siguiente comando para reiniciarlo.

```bash theme={null}
cd toolkit && bin/up -d
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.