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

# Aktualizacja TeX Live

{% hint style="danger" %}
Poniższe instrukcje **tylko** dotyczą **Community Edition** instalacji. Gorąco zalecamy, aby nasi użytkownicy Ayakaleaf Pro włączyli [Sandboxed Compiles](/on-premises/pl/konfiguracja/overleaf-toolkit/sandboxed-compiles.md) ponieważ daje to użytkownikom dostęp do niemal identycznych obrazów TeX Live używanych na [overleaf.com](/on-premises/pl/konfiguracja/overleaf-toolkit.md) a także zapewnia izolację między kompilacjami projektów, co zwiększa bezpieczeństwo.
{% endhint %}

Aby oszczędzić przepustowość, zarówno obrazy Overleaf Community Edition, jak i Ayakaleaf 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.

#### Wejście do kontenera sharelatex

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

```bash
bin/shell
```

Zobaczysz znak zachęty podobny do:

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

W poniższych instrukcjach zakładamy, że znajdujesz się w kontenerze.

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

TeX Live jest wydawany co roku około kwietnia. Kroki dotyczące 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 korzysta z TeX Live 2021:

```bash
# tlmgr --version
tlmgr wersja rewizji 59291 (2021-05-21 05:14:40 +0200)
tlmgr używa instalacji: /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 na nią poczekać i uaktualnić wdrożenie, używając `bin/upgrade` skryptu, albo, jeśli wolisz zachować starsze wydanie TeX Live, musisz najpierw poinformować `tlmgr` aby korzystał z 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 też ręcznie instalować pojedyncze pakiety:

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

{% hint style="warning" %}
Od `3.3.0` wydania wzwyż uruchamianie `tlmgr path add` 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` albo naciśnij Control-D, aby wyjść z powłoki.

#### Zapisywanie zmian

Zmiany, które właśnie wprowadziłeś, zmieniły `sharelatex` kontener, ale są ulotne — zostaną utracone, jeśli Docker Compose odtworzy kontener, np. w ramach aktualizacji konfiguracji.

Aby je utrwalić, użyj `docker commit` aby zapisać zmiany w nowym obrazie Dockera:

```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 [uaktualniasz](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://ayakaleaf-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.