> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/es/instalacion/upgrading-tex-live.md).

# Actualización de TeX Live

{% hint style="danger" %}
Las siguientes instrucciones **solo** se aplican a **Community Edition** instalaciones. Recomendamos encarecidamente que nuestros usuarios de Ayakaleaf Pro habiliten [Compilaciones aisladas](/on-premises/es/configuracion/overleaf-toolkit/sandboxed-compiles.md) ya que esto proporciona a los usuarios acceso a las imágenes TeX Live casi idénticas que se usan en [overleaf.com](/on-premises/es/configuracion/overleaf-toolkit.md) además de proporcionar aislamiento entre compilaciones de proyectos para una mayor seguridad.
{% endhint %}

Para ahorrar ancho de banda, tanto las imágenes de Overleaf Community Edition como las de Ayakaleaf Pro solo incluyen una instalación mínima de [TeX Live](https://www.tug.org/texlive/). Puedes instalar más paquetes o actualizar a una instalación completa de TeX Live usando el [tlmgr](https://www.tug.org/texlive/tlmgr.html) comando en el `sharelatex` contenedor.

#### Entrar en el contenedor sharelatex

Para iniciar una shell dentro del `sharelatex` contenedor, ejecuta

```bash
bin/shell
```

Obtendrás un prompt que se ve así:

```bash
root@309b192d4030:/#
```

En las siguientes instrucciones, supondremos que estás dentro del contenedor.

#### Determinar tu versión actual de TeX Live

TeX Live se publica cada año alrededor del mes de abril. Los pasos para usar `tlmgr` son diferentes según si estás usando la versión actual o una anterior. Puedes comprobar qué versión de TeX Live estás ejecutando con `tlmgr --version`. Por ejemplo, esta instalación ejecuta TeX Live 2021:

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021
```

{% hint style="info" %}
La versión actual de TeX Live se puede encontrar en [la página principal de TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Si estás ejecutando una versión anterior de TeX Live, tienes dos opciones. Normalmente se publica una nueva versión de la imagen Docker de Overleaf poco después de una publicación de TeX Live; puedes esperar a que esté disponible y actualizar tu despliegue usando `bin/upgrade` script, o, si prefieres mantener la versión anterior de TeX Live, primero tendrás que indicar a `tlmgr` que use un repositorio histórico. Encontrarás instrucciones para hacerlo [aquí](https://www.tug.org/texlive/acquire.html#past).

#### Instalar paquetes

Para instalar una instalación completa de TeX Live, ejecuta este comando dentro del `sharelatex` contenedor:

```
tlmgr install scheme-full
```

También puedes instalar paquetes individuales manualmente:

```bash
tlmgr install tikzlings tikzmarmots tikzducks
```

{% hint style="warning" %}
Desde `3.3.0` la versión en adelante, ejecutar `tlmgr path add` es **necesario** de nuevo después de cada uso de `tlmgr install`, para crear correctamente enlaces simbólicos de todos los binarios en la ruta del sistema.
{% endhint %}

Hay muchos más comandos disponibles. Obtén más información con:

```
tlmgr help
```

Cuando hayas terminado, escribe `exit` o pulsa Control-D para salir de la shell.

#### Guardar tus cambios

Los cambios que acabas de hacer han modificado el `sharelatex` contenedor, pero son efímeros: se perderán si Docker Compose vuelve a crear el contenedor, por ejemplo, como parte de una actualización de la configuración.

Para hacerlos persistentes, usa `docker commit` para guardar los cambios en una nueva imagen docker:

```bash
cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version
```

Después de confirmar los cambios, actualiza el `config/version` en consecuencia. Luego ejecuta `bin/up`, para recrear el `sharelatex` contenedor.

{% hint style="danger" %}
Tendrás que repetir estos pasos cada vez que [actualices](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) a una nueva versión de Overleaf.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/es/instalacion/upgrading-tex-live.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
