> 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/asennus/upgrading-tex-live.md).

# TeX Liven päivittäminen

Kaistan säästämiseksi sekä Overleaf Community Edition- että Overleaf Pro -kuvat sisältävät vain minimaalisen TeX Live -asennuksen [TeX Live](https://www.tug.org/texlive/). Voit asentaa lisää paketteja tai päivittää täyteen TeX Live -asennukseen käyttäen [tlmgr](https://www.tug.org/texlive/tlmgr.html) komentoa säilössä `sharelatex` säilön sisällä.

{% hint style="warning" %}
Seuraavat ohjeet **vain** koskevat Community Edition -asennuksia. Suosittelemme vahvasti, että Overleaf Pro -käyttäjät ottavat käyttöön [Hiekkalaatikossa suoritettavat käännökset](broken://pages/d2b36fccb235d9f16774964c517c180d49570220) sillä tämä tarjoaa käyttäjille pääsyn samoihin TeX Live -kuviin, joita käytetään [overleaf.com](/on-premises/fi/maaritys/overleaf-toolkit.md) sekä tarjoaa eristystä projektien käännösten välillä parannetun turvallisuuden vuoksi.
{% endhint %}

#### Pääsy sharelatex-säilöön

Aloittaaksesi shellin `sharelatex` säilössä, suorita

```bash
bin/shell
```

Saat kehotteen, joka näyttää tältä:

```bash
root@309b192d4030:/#
```

Seuraavissa ohjeissa oletamme, että olet säilössä.

#### Nykyisen TeX Live -version selvittäminen

TeX Live julkaistaan joka vuosi suunnilleen huhtikuun aikaan. Käyttöohjeet `tlmgr` ovat erilaisia sen mukaan, käytätkö nykyistä julkaisua vai vanhempaa versiota. Voit tarkistaa, mitä TeX Live -versiota käytät komennolla `tlmgr --version`. Esimerkiksi tämä asennus käyttää TeX Live 2021 -versiota:

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr käyttää asennusta: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) -versio 2021
```

{% hint style="info" %}
TeX Liven nykyinen julkaisu löytyy osoitteesta [TeX Liven kotisivulta](https://www.tug.org/texlive/).
{% endhint %}

Jos käytössäsi on vanhempi TeX Live -versio, sinulla on kaksi vaihtoehtoa. Overleafin Docker-kuvan uusi versio julkaistaan yleensä pian TeX Liven julkaisun jälkeen; voit joko odottaa sitä ja päivittää asennuksesi käyttämällä `bin/upgrade` skriptiä tai, jos haluat mieluummin pitää vanhemman TeX Live -julkaisun, sinun on ensin kerrottava `tlmgr` käyttävän historiallista arkistoa. Löydät ohjeet sen tekemiseen [tässä](https://www.tug.org/texlive/acquire.html#past).

#### Pakettien asentaminen

Asentaaksesi täyden TeX Live -asennuksen, suorita tämä komento `sharelatex` säilössä:

```
tlmgr install scheme-full
```

Voit myös asentaa yksittäisiä paketteja manuaalisesti:

```bash
tlmgr install tikzlings tikzmarmots tikzducks
```

{% hint style="warning" %}
Alkaen `3.3.0` julkaisusta lähtien suorittaminen `tlmgr path add` on **on tarpeen** uudelleen jokaisen `tlmgr install`käytön jälkeen, jotta kaikki binäärit voidaan linkittää oikein järjestelmän polkuun.
{% endhint %}

Saatavilla on paljon enemmän komentoja. Lue lisää komennolla:

```
tlmgr help
```

Kun olet valmis, kirjoita `exit` tai paina Control-D poistuaksesi shellistä.

#### Muutosten tallentaminen

Juuri tekemäsi muutokset ovat muuttaneet `sharelatex` säilöä, mutta ne ovat tilapäisiä -- ne menetetään, jos Docker Compose luo säilön uudelleen, esimerkiksi osana asetusten päivittämistä.

Jotta ne pysyvät pysyvinä, käytä `docker commit` tallentaaksesi muutokset uuteen docker-kuvaan:

```bash
cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version
```

Kun olet tehnyt muutokset, päivitä `config/version` sen mukaisesti. Sitten suorita `bin/up`, luodaksesi uudelleen `sharelatex` säilön sisällä.

{% hint style="danger" %}
Sinun täytyy toistaa nämä vaiheet joka kerta, kun [päivität](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) uuteen Overleaf-versioon.
{% endhint %}


---

# 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/asennus/upgrading-tex-live.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.