> 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/mantenimiento/upgrading-your-deployment.md).

# Actualización de tu implementación

{% hint style="danger" %}
Es importante asegurarte de hacer una [copia de seguridad coherente](/on-premises/es/mantenimiento/data-and-backups.md#performing-a-consistent-backup) **antes de** en cada actualización de versión principal para poder revertirla si fuera necesario.
{% endhint %}

La [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) es un repositorio git, así que es fácil obtener nuevas funciones del Toolkit. Solo ejecuta el `bin/upgrade` comando y sigue las indicaciones en pantalla.

Cabe señalar que la versión de la imagen de Docker (en `config/version`) se gestiona por separado de las actualizaciones del código del Toolkit. Actualizar el código del Toolkit **no** cambiará automáticamente la versión de la imagen de Docker que estás ejecutando. Esto significa que, en la mayoría de los casos, puedes actualizar la versión de tu Toolkit sin actualizar tu despliegue.

#### La `bin/upgrade` Script

Cuando ejecutes el `bin/upgrade` comando, el script comprobará si hay una actualización disponible del código del Toolkit y ofrecerá actualizar tu Toolkit. Siempre puedes rechazar esta actualización y no cambiará nada.

Si decides actualizar el código del Toolkit, el script comprobará entonces si la *predeterminada* versión de la imagen de Docker ha cambiado y ofrecerá actualizar tu archivo de versión local (en `config/version`) para que coincida con la nueva predeterminada.

Si decides cambiar de versión, el script te guiará a través de un proceso para detener los servicios de Docker, hacer una copia de seguridad y reiniciar los servicios de Docker. Tu antiguo archivo de versión se copiará automáticamente a `config/__old-version`, por si necesitas volver a esa versión de las imágenes de Docker.

{% hint style="danger" %}
Al realizar una actualización de Server CE/Pro, recomendamos actualizar a la última versión de la versión principal desplegada **antes de** actualizar a la última versión de la **siguiente** versión principal. Si tu despliegue está más de una versión principal por detrás de la última, deberás realizar una actualización en varios pasos.

Por ejemplo, si estás ejecutando 3.5.10, tendrás que actualizar a 3.5.13 -> Realizar la migración completa del historial del proyecto -> 4.2.9 -> 5.5.4.

Deberías **nunca** saltar versiones principales (3.5.10 -> 5.5.4). Si estás usando Toolkit y estás más de una versión principal por detrás de la última, debes **no** usar el `bin/upgrade` script, ya que tendrás que realizar una actualización manual en varios pasos.
{% endhint %}

{% hint style="info" %}
Para configuraciones aisladas de la red que importan manualmente imágenes de Docker, establece `PULL_BEFORE_UPGRADE=false` en tu `config/overleaf.rc` en el archivo.

Consulta [aquí](/on-premises/es/instalacion/air-gapped-offline-deployments.md) para obtener más información sobre el despliegue en entornos aislados de la red/sin conexión.
{% endhint %}

### Ruta de actualización <a href="#upgrade-path" id="upgrade-path"></a>

La `bin/upgrade` comando siempre elegirá la versión más reciente de Server Pro/CE disponible en ese momento. Si tu ciclo de actualización es infrecuente, esto podría hacer que se salten versiones mayores y potencialmente se actualice a una versión que no esperabas.

Al realizar una actualización, recomendamos actualizar primero a la última versión de la versión principal actual antes de actualizar a la última versión de la siguiente versión principal. Por ejemplo, si actualmente estás usando 3.3.2 y la última versión disponible es 5.3.1, la ruta de actualización correcta sería:

* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1

Para evitar cualquier problema durante la actualización, recomendamos consultar nuestras [notas de la versión](https://docs.overleaf.com/on-premises/release-notes) antes de realizar cualquier actualización, ya que ciertas versiones pueden requerir pasos adicionales. Por ejemplo, realizar cambios manuales en el Toolkit, actualizar bases de datos o ejecutar scripts de migración.

Si aún no lo has hecho, inscríbete en nuestra [lista de correo](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) para que puedas recibir notificaciones cuando se publiquen nuevas versiones/actualizaciones. Esto te permitiría programar ventanas de mantenimiento regulares que sigan de cerca nuestro calendario de publicaciones.


---

# 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/mantenimiento/upgrading-your-deployment.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.
