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

# Atualizar o TeX Live

Para poupar largura de banda, tanto as imagens da Overleaf Community Edition como as da Overleaf Pro incluem apenas 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.

{% hint style="warning" %}
As instruções seguintes **apenas** aplicam-se a instalações da Community Edition. Recomendamos vivamente que os utilizadores do Overleaf Pro ativem [Compilações em ambiente sandbox](broken://pages/138a0102db4225d7cc5647c97b88312152073ca0) uma vez que isso dá aos utilizadores acesso às mesmas imagens do TeX Live usadas no [overleaf.com](/on-premises/pt/configuracao/overleaf-toolkit.md) bem como isolamento entre compilações de projetos para maior segurança.
{% endhint %}

#### Entrar no contentor sharelatex

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

```bash
bin/shell
```

Obterá um prompt que se parece com:

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

Nas instruções seguintes, assumiremos que 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 consoante esteja a usar a versão atual ou uma mais antiga. Pode verificar que 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 revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021
```

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

Se estiver a executar uma versão mais antiga do TeX Live, tem duas opções. Normalmente, uma nova versão da imagem Docker do Overleaf é 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 antiga do TeX Live, primeiro terá de dizer 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 `3.3.0` da versão, executar `tlmgr path add` é **é necessário** novamente após cada utilização de `tlmgr install`, para criar corretamente ligações simbólicas 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 temporárias -- serão perdidas se o Docker Compose recriar o contentor, por exemplo, como parte da atualização da configuração.

Para as tornar permanentes, 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 fazer o commit das alterações, atualize o `config/version` em conformidade. Depois 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://overleaf-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.