> 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/uk/obslugovuvannya/upgrading-your-deployment.md).
# Оновлення вашого розгортання
{% hint style="danger" %}
Важливо переконатися, що ви зробите [консистентну резервну копію](/on-premises/uk/obslugovuvannya/data-and-backups.md#performing-a-consistent-backup) **перед** перед кожним оновленням основної версії, щоб за потреби ви могли виконати відкат.
{% endhint %}
Поле [Набір інструментів Overleaf↗](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 -> Виконати міграцію повної історії проєкту -> 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://ayakaleaf-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.