> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/es/mantenimiento/upgrading-your-deployment.md).

# Actualizar tu implementación

{% hint style="danger" %}
Es importante asegurarse de realizar 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 permitirte volver atrás si lo necesitas.
{% endhint %}

El [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 instrucciones 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 tu versión del Toolkit sin actualizar tu implementación.

#### El `bin/upgrade` Secuencia de comandos

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 decir que no a esta actualización y no cambiará nada.

Si decides actualizar el código del Toolkit, entonces el script comprobará 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, entonces 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 archivo de versión anterior 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, tendrás que 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 del historial completo del proyecto -> 4.2.9 -> 5.5.4.

Deberías **nunca** saltar versiones principales (3.5.10 -> 5.5.4). Si estás usando el 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 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 más información sobre la implementación en entornos aislados/sin conexión.
{% endhint %}

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

El `bin/upgrade` el 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 provocar que se salten versiones principales y, potencialmente, que actualices 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 ejecutando 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 de 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, como hacer cambios manuales en el Toolkit, actualizar bases de datos o ejecutar scripts de migración.

Si aún no lo has hecho, suscribirte a nuestra [lista de correo](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) para que se te notifique cuando se publiquen nuevas versiones/actualizaciones. Esto te permitiría programar ventanas de mantenimiento periódicas que sigan de cerca nuestro calendario de lanzamientos.


---

# 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://overleaf-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.
