> 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/uk/obslugovuvannya/upgrading-your-deployment.md).
# Оновлення вашого розгортання
{% hint style="danger" %}
Важливо переконатися, що ви створили [узгоджену резервну копію](/on-premises/uk/obslugovuvannya/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/uk/vstanovlennya/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/uk/obslugovuvannya/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.