> 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/on-premises-cs/udrzba/upgrading-your-deployment.md).

# Aktualizace vašeho nasazení

{% hint style="danger" %}
Je důležité zajistit, že provedete [konzistentní zálohu](/on-premises/on-premises-cs/udrzba/data-and-backups.md#performing-a-consistent-backup) **před** při každém upgradu na hlavní verzi, abyste se v případě potřeby mohli vrátit zpět.
{% endhint %}

Pole [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) je gitové úložiště, takže je snadné získávat nové funkce Toolkitu. Stačí spustit `bin/upgrade` příkaz a postupujte podle pokynů na obrazovce.

Stojí za zmínku, že verze Docker image (v `config/version`) je spravována odděleně od aktualizací kódu Toolkitu. Aktualizace kódu Toolkitu automaticky změní verzi Docker image, kterou používáte. To znamená, že ve většině případů můžete aktualizovat verzi Toolkitu, aniž byste museli aktualizovat nasazení. **ne** automaticky změní verzi Docker image, kterou používáte. To znamená, že ve většině případů můžete aktualizovat verzi Toolkitu, aniž byste museli aktualizovat nasazení.

#### Pole `bin/upgrade` Skript

Když spustíte `bin/upgrade` příkaz, skript zkontroluje, zda je k dispozici aktualizace kódu Toolkitu, a nabídne aktualizaci vašeho Toolkitu. Tuto aktualizaci můžete vždy odmítnout a nic se nezmění.

Pokud se rozhodnete kód Toolkitu aktualizovat, skript poté zkontroluje, zda se *výchozí* verze Docker image změnila, a nabídne aktualizaci vašeho místního souboru s verzí (v `config/version`) aby odpovídal novému výchozímu nastavení.

Pokud se rozhodnete verze změnit, skript vás poté provede procesem vypnutí služeb Dockeru, vytvoření zálohy a restartování služeb Dockeru. Váš starý soubor s verzí bude automaticky zkopírován do `config/__old-version`, pro případ, že byste se potřebovali vrátit k této verzi Docker image.

{% hint style="danger" %}
Při provádění upgradu Server CE/Pro doporučujeme upgradovat na nejnovější vydání nasazené hlavní verze **před** upgradem na nejnovější vydání **následující** hlavní verze. Pokud je vaše nasazení více než jednu hlavní verzi za nejnovější verzí, bude nutné provést vícekrokový upgrade.

Například pokud používáte 3.5.10, budete muset upgradovat na 3.5.13 -> Provést migraci Full Project History -> 4.2.9 -> 5.5.4.

Měli byste **nikdy** nepřeskakujte hlavní verze (3.5.10 -> 5.5.4). Pokud používáte Toolkit a jste více než jednu hlavní verzi za nejnovější verzí, musíte **ne** použít `bin/upgrade` skript, protože budete muset provést ruční vícekrokový upgrade.
{% endhint %}

{% hint style="info" %}
Pro izolovaná nastavení, která Docker image importují ručně, nastavte prosím `PULL_BEFORE_UPGRADE=false` ve vašem `config/overleaf.rc` soubor.

Podívejte se prosím na [zde](/on-premises/on-premises-cs/instalace/air-gapped-offline-deployments.md) pro více informací o nasazování v izolovaných/offline prostředích.
{% endhint %}

### Postup upgradu <a href="#upgrade-path" id="upgrade-path"></a>

Pole `bin/upgrade` příkaz vždy zvolí nejnovější dostupnou verzi Server Pro/CE, kterou má v danou chvíli k dispozici. Pokud své upgrady provádíte jen zřídka, může to vést k přeskočení hlavních verzí a případnému upgradu na verzi, kterou byste možná nečekali.

Při provádění upgradu doporučujeme nejprve aktualizovat na nejnovější vydání aktuální hlavní verze a teprve poté na nejnovější vydání následující hlavní verze. Například pokud právě používáte verzi 3.3.2 a nejnovější dostupná verze je 5.3.1, správný postup upgradu by byl:

* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1

Abychom předešli jakýmkoli problémům s upgradem, doporučujeme před provedením jakýchkoli upgradů nahlédnout do našich [Poznámky k vydání](https://docs.overleaf.com/on-premises/release-notes) protože některé verze mohou vyžadovat další kroky. Například ruční změny v Toolkitu, aktualizaci databází nebo spuštění migračních skriptů.

Pokud jste tak ještě neučinili, zaregistrujte se do našeho [mailing listu](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) abyste byli informováni o vydání nových verzí/aktualizací. To by vám umožnilo plánovat pravidelná údržbová okna, která budou těsně navazovat na náš harmonogram vydání.


---

# 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/on-premises-cs/udrzba/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.
