> 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/setup-docker.md).

# Configurar o Docker

O Overleaf funciona com Docker. Você deve instalar:

* Docker Engine (Docker CE)
* plugin do Docker Compose (`docker compose`, v2)

Estas etapas destinam-se a uma versão recente do Ubuntu LTS (20.04/22.04/24.04).

{% hint style="warning" %}
Evite instalar `docker.io` a partir do repositório apt predefinido do Ubuntu.\
Use o repositório oficial do Docker para obter uma versão recente do Docker e o `docker compose` plugin.
{% endhint %}

O documento oficial provém de: <https://docs.docker.com/engine/install/ubuntu/>.

{% stepper %}
{% step %}

### 1) Remova pacotes antigos/conflitantes (se existirem)

Se o Docker tiver sido instalado anteriormente de outra origem, remova-o primeiro:

{% code overflow="wrap" %}

```bash
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
```

{% endcode %}

Este comando é seguro se alguns pacotes não estiverem instalados.
{% endstep %}

{% step %}

### 2) Adicione o repositório apt oficial do Docker

Instale os pré-requisitos:

```bash
sudo apt update
sudo apt install -y ca-certificates curl
```

Adicione a chave GPG do Docker:

{% code overflow="wrap" %}

```bash
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
```

{% endcode %}

Adicione o repositório:

{% code overflow="wrap" %}

```bash
# Adicione o repositório às fontes do Apt:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
```

{% endcode %}
{% endstep %}

{% step %}

### 3) Instale o Docker Engine + o plugin Compose

Instale o Docker e o plugin Compose:

{% code overflow="wrap" %}

```bash
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

{% endcode %}

Inicie o Docker na inicialização:

```bash
sudo systemctl enable --now docker
```

{% endstep %}

{% step %}

### 4) Verifique a instalação

Estes comandos devem ser executados sem erros:

```bash
docker --version
docker compose version
sudo docker run --rm hello-world
docker ps
```

{% endstep %}

{% step %}

### 5) (Opcional) Execute o Docker sem sudo

Adicione o seu utilizador ao `docker` grupo:

```bash
sudo usermod -aG docker $USER
```

Depois **termine a sessão e volte a iniciá-la**, ou execute:

```bash
newgrp docker
```

Agora isto deve funcionar sem `sudo`:

```bash
docker ps
```

{% hint style="danger" %}
O `docker` grupo tem acesso equivalente ao root no anfitrião.\
Isto é esperado em instalações típicas do Overleaf e é especialmente relevante se ativar Compilações em sandbox.
{% endhint %}
{% endstep %}
{% endstepper %}

### Próximo passo

Quando o Docker estiver a funcionar, continue com os passos de instalação do Toolkit em [Usando o Toolkit](/on-premises/pt/instalacao/using-the-toolkit.md).


---

# 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/setup-docker.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.