> 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/es/primeros-pasos/requirements/setup-docker.md).

# Configurar Docker

Overleaf funciona con Docker. Debes instalar:

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

Estos pasos están dirigidos a una Ubuntu LTS reciente (20.04/22.04/24.04).

{% hint style="warning" %}
Evita instalar `docker.io` del repositorio apt predeterminado de Ubuntu.\
Usa el repositorio oficial de Docker para obtener una versión reciente de Docker y el `docker compose` plugin.
{% endhint %}

El documento oficial proviene de: <https://docs.docker.com/engine/install/ubuntu/>.

{% stepper %}
{% step %}

### 1) Eliminar paquetes antiguos o en conflicto (si existen)

Si Docker se instaló previamente desde otra fuente, elimínalo primero:

{% 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 es seguro si algunos paquetes no están instalados.
{% endstep %}

{% step %}

### 2) Añadir el repositorio apt oficial de Docker

Instala los requisitos previos:

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

Añade la clave GPG de 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 %}

Añade el repositorio:

{% code overflow="wrap" %}

```bash
# Añade el repositorio a las fuentes de Apt:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Tipos: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Componentes: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
```

{% endcode %}
{% endstep %}

{% step %}

### 3) Instalar Docker Engine + plugin de Compose

Instala Docker y el plugin de Compose:

{% code overflow="wrap" %}

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

{% endcode %}

Inicia Docker al arrancar:

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

{% endstep %}

{% step %}

### 4) Verificar la instalación

Estos comandos deberían ejecutarse sin errores:

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

{% endstep %}

{% step %}

### 5) (Opcional) Ejecutar Docker sin sudo

Añade tu usuario al `docker` grupo:

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

Luego **cierra sesión y vuelve a iniciarla**, o ejecuta:

```bash
newgrp docker
```

Ahora esto debería funcionar sin `sudo`:

```bash
docker ps
```

{% hint style="danger" %}
El `docker` el grupo tiene acceso equivalente al de root en el host.\
Esto es esperado en instalaciones típicas de Overleaf, y especialmente relevante si habilitas las compilaciones en modo aislado.
{% endhint %}
{% endstep %}
{% endstepper %}

### Siguiente paso

Una vez que Docker esté funcionando, continúa con los pasos de instalación del Toolkit en [Uso del Toolkit](/on-premises/es/instalacion/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://overleaf-pro.ayaka.space/on-premises/es/primeros-pasos/requirements/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.