> ## 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. Installer Docker

> Installez Docker Engine et le plugin Compose sur Ubuntu pour un déploiement d'Overleaf.

Overleaf fonctionne sur Docker. Vous devez installer :

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

Ces étapes ciblent une version LTS récente d'Ubuntu (20.04/22.04/24.04).

> [!WARNING]
>
> Évitez d'installer `docker.io` depuis le dépôt apt par défaut d'Ubuntu.\
> Utilisez le dépôt officiel de Docker afin d'obtenir une version récente de Docker et le plugin `docker compose`.

La documentation officielle est disponible ici : [https://docs.docker.com/engine/install/ubuntu/](https://docs.docker.com/engine/install/ubuntu/).

**1. 1) Supprimer les paquets anciens ou en conflit (le cas échéant)**

Si Docker a déjà été installé depuis une autre source, supprimez-le d'abord :

```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)
```

Cette commande est sans risque même si certains paquets ne sont pas installés.

**2. 2) Ajouter le dépôt apt officiel de Docker**

Installez les prérequis :

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

Ajoutez la clé GPG de Docker :

```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
```

Ajoutez le dépôt :

```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) Installer Docker Engine et le plugin Compose**

Installez Docker et le plugin Compose :

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

Lancez Docker au démarrage :

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

**4. 4) Vérifier l'installation**

Ces commandes doivent s'exécuter sans erreur :

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

**5. 5) (Facultatif) Exécuter Docker sans sudo**

Ajoutez votre utilisateur au groupe `docker` :

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

Ensuite, **déconnectez-vous puis reconnectez-vous**, ou exécutez :

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

La commande suivante devrait désormais fonctionner sans `sudo` :

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

> [!CAUTION]
>
> Le groupe `docker` dispose d'un accès équivalent à root sur l'hôte.\
> C'est normal pour les installations Overleaf classiques, et particulièrement pertinent si vous activez les compilations isolées (Sandboxed Compiles).

### Étape suivante

Une fois Docker opérationnel, poursuivez avec [1. Télécharger le Toolkit](https://ayakaleaf-pro.mintlify.site/fr/on-premises/installation/using-the-toolkit/1.-download-the-toolkit.md).


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