> 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/ru/obsluzhivanie/upgrading-your-deployment.md).
# Обновление вашего развёртывания
{% hint style="danger" %}
Важно убедиться, что вы делаете [консистентную резервную копию](/on-premises/ru/obsluzhivanie/data-and-backups.md#performing-a-consistent-backup) **до** при каждом обновлении major-версии, чтобы при необходимости можно было откатиться.
{% 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 мы рекомендуем сначала обновиться до последнего выпуска установленной major-версии **до** перед обновлением до последнего выпуска **следующей** major-версии. Если ваша установка отстает от последней более чем на одну major-версию, вам потребуется выполнить многоэтапное обновление.
Например, если у вас установлена 3.5.10, вам нужно будет обновиться до 3.5.13 -> выполнить миграцию Full Project History -> 4.2.9 -> 5.5.4.
Вам следует **никогда** пропускать major-версии (3.5.10 -> 5.5.4). Если вы используете Toolkit и отстаете от последней более чем на одну major-версию, вы должны **не** использовать `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, доступную на тот момент. Если вы обновляетесь нечасто, это может привести к пропуску основных версий и, возможно, к обновлению до версии, которую вы не ожидали.
При выполнении обновления мы рекомендуем сначала обновиться до последнего выпуска текущей основной версии, прежде чем переходить к последнему выпуску следующей основной версии. Например, если сейчас у вас 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://overleaf-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.