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

# Aktualizace vaší instalace

{% hint style="danger" %}
Je důležité zajistit, abyste provedli [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 hlavní verze, abyste se mohli v případě potřeby vrátit zpět.
{% endhint %}

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

Stojí za zmínku, že verze image Dockeru (v `config/version`) se spravuje odděleně od aktualizací kódu Toolkitu. Aktualizace kódu Toolkitu **ne** automaticky změní verzi image Dockeru, kterou používáte. To znamená, že ve většině případů můžete verzi Toolkitu aktualizovat bez aktualizace 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 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 *výchozí* se změnila verze image Dockeru, a nabídne aktualizaci vašeho místního souboru s verzí (v `config/version`) tak, aby odpovídal novému výchozímu nastavení.

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

{% 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í za nejnovější verzí o více než jednu hlavní verzi pozadu, budete muset provést vícekrokový upgrade.

Například pokud používáte 3.5.10, budete muset upgradovat na 3.5.13 -> Proveďte 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 o více než jednu hlavní verzi pozadu vůči nejnovější verzi, 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á prostředí bez přístupu k síti, 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 %}

### Cesta aktualizace <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 daný okamžik k dispozici. Pokud aktualizujete jen zřídka, může to vést k přeskočení hlavních verzí a případně k aktualizaci na verzi, kterou byste nečekali.

Při provádění aktualizace doporučujeme nejprve aktualizovat na nejnovější vydání aktuální hlavní verze a teprve poté na nejnovější vydání další hlavní verze. Pokud například právě používáte verzi 3.3.2 a nejnovější dostupná verze je 5.3.1, správná cesta aktualizace by byla:

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

Abychom předešli problémům s aktualizací, doporučujeme prostudovat naše [Poznámky k vydání](https://docs.overleaf.com/on-premises/release-notes) před provedením jakýchkoli aktualizací, 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, přihlaste se k našemu [mailing listu](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) abyste dostávali upozornění, když budou vydány nové verze/aktualizace. To by vám umožnilo naplánovat pravidelná okna údržby, která budou těsně navazovat na náš plán vydává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://overleaf-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.
