> 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/ru/obsluzhivanie/upgrading-your-deployment.md).
# Обновление вашего развёртывания
{% hint style="danger" %}
Важно убедиться, что вы делаете [консистентную резервную копию](/on-premises/ru/obsluzhivanie/data-and-backups.md#performing-a-consistent-backup) **перед** при каждом обновлении до новой основной версии, чтобы при необходимости вы могли откатиться.
{% endhint %}
Параметр [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) — это git-репозиторий, поэтому получать новые функции Toolkit легко. Просто выполните `bin/upgrade` команду и следуйте инструкциям на экране.
Стоит отметить, что версия Docker-образа (в `config/version`) управляется отдельно от обновлений кода Toolkit. Обновление кода Toolkit будет **не** автоматически изменять версию Docker-образа, который вы используете. Это означает, что в большинстве случаев вы можете обновить версию Toolkit, не обновляя своё развёртывание.
#### Параметр `bin/upgrade` Скрипт
Когда вы запускаете `bin/upgrade` команду, скрипт проверит, доступно ли обновление кода Toolkit, и предложит обновить ваш Toolkit. Вы всегда можете отказаться от этого обновления, и ничего не изменится.
Если вы всё же решите обновить код Toolkit, скрипт затем проверит, изменился ли *по умолчанию* версия Docker-образа, и предложит обновить ваш локальный файл версии (в `config/version`) чтобы он соответствовал новому значению по умолчанию.
Если вы всё же решите переключить версии, скрипт проведёт вас через процесс остановки служб Docker, создания резервной копии и перезапуска служб Docker. Ваш старый файл версии будет автоматически скопирован в `config/__old-version`, на случай если вам понадобится откатиться к этой версии Docker-образов.
{% hint style="danger" %}
При выполнении обновления Server CE/Pro мы рекомендуем обновиться до последнего выпуска развернутой основной версии **перед** обновлением до последнего выпуска **следующей** основной версии. Если ваш развернутый экземпляр отстает от последней более чем на одну основную версию, вам потребуется выполнить многоэтапное обновление.
Например, если у вас используется 3.5.10, вам нужно будет обновиться до 3.5.13 -> выполнить миграцию Full Project History -> 4.2.9 -> 5.5.4.
Вам следует **никогда** пропускать основные версии (3.5.10 -> 5.5.4). Если вы используете Toolkit и отстаете от последней более чем на одну основную версию, вы должны **не** использовать `bin/upgrade` скрипт, поскольку вам потребуется выполнить многоэтапное обновление вручную.
{% endhint %}
{% hint style="info" %}
Для изолированных установок, которые вручную импортируют Docker-образы, установите `PULL_BEFORE_UPGRADE=false` в вашем `config/overleaf.rc` в файл.
Пожалуйста, см. [здесь](/on-premises/ru/ustanovka/air-gapped-offline-deployments.md) для получения дополнительной информации о развёртывании в изолированных/офлайн-средах.
{% endhint %}
### Путь обновления
Параметр `bin/upgrade` команда всегда будет выбирать самую последнюю версию Server Pro/CE, доступную ей на тот момент. Если вы обновляетесь редко, это может привести к пропуску крупных версий и, возможно, обновлению до версии, которую вы не ожидали.
При выполнении обновления мы рекомендуем сначала обновиться до последнего релиза текущей major-версии, а уже затем — до последнего релиза следующей major-версии. Например, если у вас сейчас версия 3.3.2, а последняя доступная версия — 5.3.1, правильный путь обновления будет таким:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Чтобы избежать проблем при обновлении, мы рекомендуем ознакомиться с нашими [примечаниями к выпуску](https://docs.overleaf.com/on-premises/release-notes) перед выполнением любых обновлений, поскольку для некоторых версий могут потребоваться дополнительные шаги, например, ручные изменения в Toolkit, обновление баз данных или запуск скриптов миграции.
Если вы ещё этого не сделали, подпишитесь на нашу [рассылку](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) чтобы получать уведомления о выходе новых версий/обновлений. Это позволит вам планировать регулярные окна обслуживания в соответствии с нашим графиком выпусков.
---
# 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/ru/obsluzhivanie/upgrading-your-deployment.md?ask=&goal=
```
`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.