> 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/fi/yllapito/upgrading-your-deployment.md).
# Käyttöönoton päivittäminen
{% hint style="danger" %}
On tärkeää varmistaa, että otat [johdonmukaisen varmuuskopion](/on-premises/fi/yllapito/data-and-backups.md#performing-a-consistent-backup) **ennen** jokaisen pääversion päivityksen yhteydessä, jotta voit tarvittaessa palata takaisin.
{% endhint %}
Se [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) on git-repositorio, joten uusien Toolkit-ominaisuuksien saaminen on helppoa. Suorita vain `bin/upgrade` komento ja seuraa näytön kehotteita.
On syytä huomata, että Docker-kuvan versio (kohdassa `config/version`) hallinnoidaan erillään Toolkitin koodipäivityksistä. Toolkitin koodin päivittäminen **ei** muuttaa automaattisesti käyttämäsi Docker-kuvan version. Tämä tarkoittaa, että useimmissa tapauksissa voit päivittää Toolkit-versiosi ilman, että sinun tarvitsee päivittää käyttöönottoasi.
#### Se `bin/upgrade` Skripti
Kun suoritat `bin/upgrade` komennon, skripti tarkistaa, onko Toolkitin 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ää Toolkitin koodin, skripti tarkistaa sitten, onko *oletus* Docker-kuvan oletusversio muuttunut, ja tarjoaa paikallisen versiotiedostosi päivittämistä (kohdassa `config/version`) vastaamaan uutta oletusarvoa.
Jos päätät vaihtaa versiota, skripti opastaa sinua sitten Docker-palveluiden pysäyttämisessä, varmuuskopion tekemisessä ja Docker-palveluiden käynnistämisessä uudelleen. Vanha versiotiedostosi kopioidaan automaattisesti kohtaan `config/__old-version`, siltä varalta, että sinun täytyy palata kyseiseen Docker-kuvien versioon.
{% hint style="danger" %}
Kun teet Server CE/Pro -päivitystä, suosittelemme päivittämään ensin käyttöönotetun pääversion uusimpaan julkaisuun **ennen** kuin päivität **seuraavan** pääversion uusimpaan julkaisuun. Jos käyttöönotettasi on enemmän kuin yksi pääversio jäljessä uusimmasta, sinun on tehtävä monivaiheinen päivitys.
Jos esimerkiksi 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** ohita pääversioita (3.5.10 -> 5.5.4). Jos käytät Toolkitia ja olet enemmän kuin yhden pääversion jäljessä uusimmasta, sinun täytyy **ei** käyttää `bin/upgrade` skriptiä, koska sinun täytyy tehdä manuaalinen monivaiheinen päivitys.
{% endhint %}
{% hint style="info" %}
Ilmaraossa olevissa ympäristöissä, joissa Docker-kuvat tuodaan manuaalisesti, aseta `PULL_BEFORE_UPGRADE=false` tiedostossasi `config/overleaf.rc` tiedostoon.
Tarkista [täältä](/on-premises/fi/asennus/air-gapped-offline-deployments.md) lisätietoja käyttöönotosta ilmaraossa/offline-ympäristöissä.
{% endhint %}
### Päivityspolku
Se `bin/upgrade` komento valitsee aina sillä hetkellä saatavilla olevista Server Pro/CE -versioista uusimman. Jos päivityssyklisi on harva, tämä voi johtaa pääversioiden ohittamiseen ja mahdollisesti päivittämiseen versioon, jota et olisi odottanut.
Kun suoritat päivitystä, suosittelemme päivittämään ensin nykyisen pääversion uusimpaan julkaisuun ennen siirtymistä seuraavan pääversion uusimpaan julkaisuun. Esimerkiksi, jos käytät tällä hetkellä versiota 3.3.2 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 päivitysten tekemistä, sillä jotkin versiot saattavat vaatia lisätoimia, kuten manuaalisia muutoksia Toolkitissä, tietokantojen päivittämistä tai migraatioskriptien suorittamista.
Jos et ole vielä tehnyt niin, liity [postituslistallemme](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) jotta saat ilmoituksen, kun uusia versioita/päivityksiä julkaistaan. Näin voit ajoittaa säännölliset huoltokatkot, jotka seuraavat tiiviisti julkaisuohjelmaamme.
---
# 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/fi/yllapito/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.