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

# Aktualizacja TeX Live

Aby zaoszczędzić pasmo, zarówno obrazy Overleaf Community Edition, jak i Overleaf Pro zawierają tylko minimalną instalację [TeX Live](https://www.tug.org/texlive/). Możesz zainstalować więcej pakietów lub uaktualnić do pełnej instalacji TeX Live, używając [tlmgr](https://www.tug.org/texlive/tlmgr.html) polecenia w `sharelatex` kontenerze.

{% hint style="warning" %}
Poniższe instrukcje **tylko** dotyczą instalacji Community Edition. Zdecydowanie zalecamy, aby użytkownicy Overleaf Pro włączyli [Kompilacjami w piaskownicy](broken://pages/7c37733a19dc1c686aed43c2239f438f97da881d) ponieważ zapewnia to użytkownikom dostęp do tych samych obrazów TeX Live używanych w [overleaf.com](/on-premises/pl/konfiguracja/overleaf-toolkit.md) a także zapewnia izolację między kompilacjami projektów dla zwiększonego bezpieczeństwa.
{% endhint %}

#### Wejście do kontenera sharelatex

Aby uruchomić powłokę wewnątrz `sharelatex` kontenera, uruchom

```bash
bin/shell
```

Zobaczysz monit wyglądający tak:

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

W poniższych instrukcjach przyjmiemy, że znajdujesz się w kontenerze.

#### Określanie bieżącej wersji TeX Live

TeX Live jest wydawany co roku mniej więcej w kwietniu. Kroki użycia `tlmgr` różnią się w zależności od tego, czy używasz bieżącego wydania, czy starszego. Możesz sprawdzić, której wersji TeX Live używasz, za pomocą `tlmgr --version`. Na przykład ta instalacja używa TeX Live 2021:

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) wersja 2021
```

{% hint style="info" %}
Aktualne wydanie TeX Live można znaleźć na [stronie głównej TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Jeśli używasz starszej wersji TeX Live, masz dwie opcje. Nowa wersja obrazu Docker Overleaf jest zwykle wydawana krótko po wydaniu TeX Live; możesz albo poczekać na nią i uaktualnić swoje wdrożenie za pomocą `bin/upgrade` skryptu, albo jeśli wolisz zachować starsze wydanie TeX Live, najpierw będziesz musiał poinformować `tlmgr` aby używał historycznego repozytorium. Instrukcje, jak to zrobić, znajdziesz [tutaj](https://www.tug.org/texlive/acquire.html#past).

#### Instalowanie pakietów

Aby zainstalować pełną instalację TeX Live, uruchom to polecenie wewnątrz `sharelatex` kontenera:

```
tlmgr install scheme-full
```

Możesz także ręcznie instalować pojedyncze pakiety:

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

{% hint style="warning" %}
Od `3.3.0` wydania wzwyż uruchamianie `tlmgr path add` ma wartość **jest wymagane** ponownie po każdym użyciu `tlmgr install`, aby poprawnie utworzyć dowiązania symboliczne do wszystkich plików binarnych w ścieżce systemowej.
{% endhint %}

Dostępnych jest znacznie więcej poleceń. Dowiedz się więcej za pomocą:

```
tlmgr help
```

Gdy skończysz, wpisz `exit` lub naciśnij Ctrl-D, aby wyjść z powłoki.

#### Zapisywanie zmian

Wprowadzone właśnie zmiany zmieniły `sharelatex` kontener, ale są ulotne — zostaną utracone, jeśli Docker Compose utworzy kontener ponownie, np. w ramach aktualizacji konfiguracji.

Aby uczynić je trwałymi, użyj `docker commit` aby zapisać zmiany w nowym obrazie Docker:

```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
```

Po zatwierdzeniu zmian zaktualizuj `config/version` odpowiednio. Następnie uruchom `bin/up`, aby ponownie utworzyć `sharelatex` kontenerze.

{% hint style="danger" %}
Będziesz musiał powtarzać te kroki za każdym razem, gdy [uaktualnisz](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) do nowej wersji Overleaf.
{% 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/pl/instalacja/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.