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

# Atualizar o TeX Live

{% hint style="danger" %}
As instruções a seguir **apenas** aplicam-se a **Edição Comunitária** instalações. Recomendamos fortemente que os utilizadores do nosso Ayakaleaf Pro ativem [Compilações em ambiente sandbox](/on-premises/pt/configuracao/overleaf-toolkit/sandboxed-compiles.md) pois isso fornece aos utilizadores acesso a imagens do TeX Live quase idênticas às usadas em [overleaf.com](/on-premises/pt/configuracao/overleaf-toolkit.md) bem como isolamento entre compilações de projetos para maior segurança.
{% endhint %}

Para poupar largura de banda, as imagens do Overleaf Community Edition e do Ayakaleaf Pro vêm apenas com uma instalação mínima de [TeX Live](https://www.tug.org/texlive/). Pode instalar mais pacotes ou atualizar para uma instalação completa do TeX Live usando o [tlmgr](https://www.tug.org/texlive/tlmgr.html) comando no `sharelatex` contentor.

#### Aceder ao contentor sharelatex

Para iniciar uma shell dentro do `sharelatex` contentor, execute

```bash
bin/shell
```

Receberá um prompt que se parece com:

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

Nas instruções seguintes, assumiremos que você está no contentor.

#### Determinar a sua versão atual do TeX Live

O TeX Live é lançado todos os anos por volta do mês de abril. Os passos para usar `tlmgr` são diferentes dependendo de estar a usar a versão atual ou uma mais antiga. Pode verificar qual versão do TeX Live está a executar com `tlmgr --version`. Por exemplo, esta instalação executa o TeX Live 2021:

```bash
# tlmgr --version
tlmgr revisão 59291 (2021-05-21 05:14:40 +0200)
tlmgr a usar a instalação: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) versão 2021
```

{% hint style="info" %}
A versão atual do TeX Live pode ser encontrada em [a página inicial do TeX Live](https://www.tug.org/texlive/).
{% endhint %}

Se estiver a usar uma versão mais antiga do TeX Live, tem duas opções. Uma nova versão da imagem Docker do Overleaf é normalmente lançada pouco depois de uma versão do TeX Live; pode esperar por ela e atualizar a sua implementação usando o `bin/upgrade` script, ou, se preferir manter a versão mais antiga do TeX Live, primeiro terá de indicar ao `tlmgr` para usar um repositório histórico. Encontrará instruções para o fazer [aqui](https://www.tug.org/texlive/acquire.html#past).

#### Instalar pacotes

Para instalar uma instalação completa do TeX Live, execute este comando dentro do `sharelatex` contentor:

```
tlmgr install scheme-full
```

Também pode instalar pacotes individuais manualmente:

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

{% hint style="warning" %}
A partir de `3.3.0` versão em diante, executar `tlmgr path add` é **necessário** novamente após cada utilização de `tlmgr install`, para criar corretamente links simbólicos para todos os binários no caminho do sistema.
{% endhint %}

Há muitos mais comandos disponíveis. Saiba mais com:

```
tlmgr help
```

Quando terminar, escreva `exit` ou prima Control-D para sair da shell.

#### Guardar as suas alterações

As alterações que acabou de fazer alteraram o `sharelatex` contentor, mas são efémeras -- serão perdidas se o Docker Compose recriar o contentor, por exemplo, como parte da atualização da configuração.

Para as tornar persistentes, use `docker commit` para guardar as alterações numa nova imagem 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
```

Depois de confirmar as alterações, atualize o `config/version` em conformidade. Em seguida, execute `bin/up`, para recriar o `sharelatex` contentor.

{% hint style="danger" %}
Terá de repetir estes passos sempre que [atualizar](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) para uma nova versão do 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/pt/instalacao/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.