> 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/de/erste-schritte/requirements/setup-docker.md).

# Docker einrichten

Overleaf läuft auf Docker. Sie müssen Folgendes installieren:

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

Diese Schritte richten sich an ein aktuelles Ubuntu LTS (20.04/22.04/24.04).

{% hint style="warning" %}
Installieren Sie nicht `docker.io` aus dem standardmäßigen apt-Repository von Ubuntu.\
Verwenden Sie das offizielle Docker-Repository, damit Sie eine aktuelle Docker-Version und das `docker compose` Plugin erhalten.
{% endhint %}

Das offizielle Dokument stammt von: <https://docs.docker.com/engine/install/ubuntu/>.

{% stepper %}
{% step %}

### 1) Alte/konfliktierende Pakete entfernen (falls vorhanden)

Wenn Docker zuvor aus einer anderen Quelle installiert wurde, entfernen Sie es zunächst:

{% 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 %}

Dieser Befehl ist unbedenklich, wenn einige Pakete nicht installiert sind.
{% endstep %}

{% step %}

### 2) Offizielles apt-Repository von Docker hinzufügen

Voraussetzungen installieren:

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

Den Docker-GPG-Schlüssel hinzufügen:

{% 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 %}

Das Repository hinzufügen:

{% code overflow="wrap" %}

```bash
# Das Repository zu den Apt-Quellen hinzufügen:
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) Docker Engine + Compose-Plugin installieren

Docker und das Compose-Plugin installieren:

{% code overflow="wrap" %}

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

{% endcode %}

Docker beim Starten des Systems starten:

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

{% endstep %}

{% step %}

### 4) Installation überprüfen

Diese Befehle sollten ohne Fehler ausgeführt werden:

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

{% endstep %}

{% step %}

### 5) (Optional) Docker ohne sudo ausführen

Fügen Sie Ihren Benutzer zur `docker` Gruppe hinzu:

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

Dann **melden Sie sich ab und wieder an**, oder führen Sie aus:

```bash
newgrp docker
```

Jetzt sollte dies ohne `sudo`:

```bash
docker ps
```

{% hint style="danger" %}
Die `docker` Die Gruppe hat auf dem Host Zugriff mit Root-Äquivalent.\
Dies ist bei typischen Overleaf-Installationen zu erwarten und besonders relevant, wenn Sie Sandboxed Compiles aktivieren.
{% endhint %}
{% endstep %}
{% endstepper %}

### Nächster Schritt

Sobald Docker funktioniert, fahren Sie mit den Installationsschritten des Toolkits in [Toolkit verwenden](/on-premises/de/installation/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/de/erste-schritte/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.