> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 0. Docker einrichten

> Installieren Sie Docker Engine und das Compose-Plugin unter Ubuntu für eine Overleaf-Bereitstellung.

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 eine aktuelle Ubuntu-LTS-Version (20.04/22.04/24.04).

> [!WARNING]
>
> Vermeiden Sie die Installation von `docker.io` aus dem Standard-apt-Repository von Ubuntu.\
> Verwenden Sie das offizielle Docker-Repository, damit Sie eine aktuelle Docker-Version und das `docker compose`-Plugin erhalten.

Die offizielle Dokumentation finden Sie unter: [https://docs.docker.com/engine/install/ubuntu/](https://docs.docker.com/engine/install/ubuntu/).

**1. 1) Alte/konfliktverursachende Pakete entfernen (falls vorhanden)**

Wenn Docker zuvor aus einer anderen Quelle installiert wurde, entfernen Sie es zuerst:

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

Dieser Befehl ist auch dann sicher, wenn einige Pakete nicht installiert sind.

**2. 2) Offizielles apt-Repository von Docker hinzufügen**

Installieren Sie die Voraussetzungen:

```bash theme={null}
sudo apt update
sudo apt install -y ca-certificates curl
```

Fügen Sie den Docker-GPG-Schlüssel hinzu:

```bash wrap theme={null}
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
```

Fügen Sie das Repository hinzu:

```bash wrap theme={null}
# Add the repository to Apt sources:
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
```

**3. 3) Docker Engine + Compose-Plugin installieren**

Installieren Sie Docker und das Compose-Plugin:

```bash wrap theme={null}
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

Starten Sie Docker beim Systemstart:

```bash theme={null}
sudo systemctl enable --now docker
```

**4. 4) Installation überprüfen**

Diese Befehle sollten ohne Fehler ausgeführt werden:

```bash theme={null}
docker --version
docker compose version
sudo docker run --rm hello-world
docker ps
```

**5. 5) (Optional) Docker ohne sudo ausführen**

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

```bash theme={null}
sudo usermod -aG docker $USER
```

Melden Sie sich anschließend **ab und wieder an**, oder führen Sie Folgendes aus:

```bash theme={null}
newgrp docker
```

Nun sollte dies ohne `sudo` funktionieren:

```bash theme={null}
docker ps
```

> [!CAUTION]
>
> Die Gruppe `docker` hat auf dem Host Zugriffsrechte, die root entsprechen.\
> Das ist bei typischen Overleaf-Installationen so vorgesehen und besonders relevant, wenn Sie Sandboxed Compiles aktivieren.

### Nächster Schritt

Sobald Docker funktioniert, fahren Sie mit [1. Toolkit herunterladen](https://ayakaleaf-pro.mintlify.site/de/on-premises/installation/using-the-toolkit/1.-download-the-toolkit.md) fort.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.