> 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/fi/yllapito/upgrading-your-deployment.md).

# Käyttöönoton päivittäminen

{% hint style="danger" %}
On tärkeää varmistaa, että otat [eheän varmuuskopion](/on-premises/fi/yllapito/data-and-backups.md#performing-a-consistent-backup) **ennen** jokaisen pääversion päivityksen yhteydessä, jotta voit tarvittaessa palauttaa aiemman tilanteen.
{% endhint %}

Kentän [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) on git-repositorio, joten uusien Toolkit-ominaisuuksien hankkiminen on helppoa. Suorita vain `bin/upgrade` komento ja seuraa näytön ohjeita.

On syytä huomata, että Docker-kuvan versio (kohdassa `config/version`) hallitaan erikseen Toolkit-koodipäivityksistä. Toolkit-koodin päivittäminen **ei** muuttaa automaattisesti käyttämäsi Docker-kuvan versiota. Tämä tarkoittaa, että useimmissa tapauksissa voit päivittää Toolkit-versiosi päivittämättä käyttöönottoasi.

#### Kentän `bin/upgrade` Skripti

Kun suoritat `bin/upgrade` komennon, skripti tarkistaa, onko Toolkit-koodille saatavilla päivitystä, ja tarjoaa Toolkitin päivittämistä. Voit aina kieltäytyä tästä päivityksestä, eikä mikään muutu.

Jos päätät päivittää Toolkit-koodin, skripti tarkistaa sitten, onko *oletus* Docker-kuvan versio muuttunut, ja tarjoaa paikallisen versiotiedostosi päivittämistä (kohdassa `config/version`) vastaamaan uutta oletusta.

Jos päätät vaihtaa versiota, skripti opastaa sinut sitten Docker-palveluiden sammuttamisen, varmuuskopion tekemisen ja Docker-palveluiden käynnistämisen uudelleen läpi. Vanha versiotiedostosi kopioidaan automaattisesti kohteeseen `config/__old-version`, siltä varalta, että sinun täytyy palauttaa kyseinen Docker-kuvien versio.

{% hint style="danger" %}
Kun teet Server CE/Pro -päivityksen, suosittelemme päivittämään ensin käytössä olevan pääversion viimeisimpään julkaisuun **ennen** päivittämistä viimeisimpään julkaisuun **seuraavan** pääversion. Jos käyttöönotto on yli yhden pääversion jäljessä uusimmasta, sinun on tehtävä monivaiheinen päivitys.

Esimerkiksi, jos käytössäsi on 3.5.10, sinun on päivitettävä versioon 3.5.13 -> suoritettava Full Project History -migraatio -> 4.2.9 -> 5.5.4.

Sinun pitäisi **ei koskaan** ohittaa pääversioita (3.5.10 -> 5.5.4). Jos käytät Toolkitia ja olet yli yhden pääversion jäljessä uusimmasta, sinun täytyy **ei** käyttää `bin/upgrade` skriptiä, sillä sinun on tehtävä manuaalinen monivaiheinen päivitys.
{% endhint %}

{% hint style="info" %}
Manuaalisesti Docker-kuvia tuovissa air-gapped-ympäristöissä aseta `PULL_BEFORE_UPGRADE=false` tiedostoosi `config/overleaf.rc` tiedosto.

Tarkista [tässä](/on-premises/fi/asennus/air-gapped-offline-deployments.md) lisätietoja käyttöönotosta air-gapped-/offline-ympäristöissä.
{% endhint %}

### Päivityspolku <a href="#upgrade-path" id="upgrade-path"></a>

Kentän `bin/upgrade` komento valitsee aina sillä hetkellä saatavilla olevan Server Pro/CE:n uusimman version. Jos päivityssyklisi on harvinainen, tämä voi johtaa pääversioiden ohittamiseen ja mahdollisesti päivittämiseen versioon, jota et ehkä odottanut.

Päivitystä tehdessä suosittelemme päivittämään ensin nykyisen pääversion uusimpaan julkaisuun ennen päivittämistä seuraavan pääversion uusimpaan julkaisuun. Esimerkiksi, jos käytät tällä hetkellä 3.3.2:ta ja uusin saatavilla oleva versio on 5.3.1, oikea päivityspolku olisi:

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

Päivitysongelmien välttämiseksi suosittelemme tutustumaan [julkaisutietoihimme](https://docs.overleaf.com/on-premises/release-notes) ennen kuin teet mitään päivityksiä, sillä tietyt versiot saattavat vaatia lisävaiheita, kuten manuaalisia muutoksia Toolkitissä, tietokantojen päivittämistä tai siirtoskriptien suorittamista.

Jos et ole vielä tehnyt niin, liittymällä [postituslistallemme](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) voit saada ilmoituksen, kun uusia versioita/päivityksiä julkaistaan. Tämä auttaa sinua ajoittamaan säännölliset ylläpitoikkunat, jotka seuraavat tiiviisti julkaisuaikatauluamme.


---

# 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/fi/yllapito/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.