# Installation de Docker sur Ubuntu 20.04 - Guide Complet                                                      [[plan_du_site| Retour au plan du site]]

---

## 📌 Introduction

Ce guide détaille les étapes pour installer **Docker Engine** sur un système **Ubuntu 20.04 LTS** en utilisant le dépôt officiel de Docker. Cette méthode garantit une installation stable, sécurisée et à jour.

---

## ✅ Prérequis

- Un système **Ubuntu 20.04 LTS** (Focal Fossa).
- Un accès **root** ou un utilisateur avec des privilèges `sudo`.
- Une connexion Internet active.

---

## 🛠️ Étapes d'installation

### 1. Mettre à jour les paquets existants

Avant toute installation, mettez à jour votre système :

```bash
sudo apt update && sudo apt upgrade -y
```

---

### 2. Installer les dépendances nécessaires

Installez les paquets requis pour ajouter de nouveaux dépôts via HTTPS :

```bash
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
```

---

### 3. Ajouter la clé GPG officielle de Docker

Ajoutez la clé GPG de Docker pour vérifier l'authenticité des paquets :

```bash
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
```

---

### 4. Ajouter le dépôt Docker aux sources APT

Ajoutez le dépôt officiel de Docker pour Ubuntu 20.04 :

```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

---

### 5. Installer Docker Engine

Mettez à jour l'index des paquets et installez Docker :

```bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
```

---

### 6. Vérifier l'installation

Testez Docker en exécutant un conteneur de test :

```bash
sudo docker run hello-world
```

Si l'installation est réussie, vous devriez voir un message de confirmation.

---

### 7. (Optionnel) Ajouter votre utilisateur au groupe Docker

Pour éviter d'utiliser `sudo` à chaque commande Docker, ajoutez votre utilisateur au groupe `docker` :

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

**⚠️ Important** : Redémarrez votre session pour appliquer les changements.

---

### 8. Vérifier la version de Docker

```bash
docker --version
```

---

## 🔧 Configuration supplémentaire (Optionnel)

### Activer le démarrage automatique de Docker

Pour que Docker démarre automatiquement au boot :

```bash
sudo systemctl enable docker
```

### Démarrer Docker manuellement

```bash
sudo systemctl start docker
```

### Vérifier le statut de Docker

```bash
sudo systemctl status docker
```

---

## 🧪 Tester Docker

### Lancer un conteneur Nginx

```bash
sudo docker run -d -p 80:80 --name webserver nginx
```

- Accédez à `http://localhost` dans votre navigateur pour voir la page d'accueil de Nginx.

### Arrêter le conteneur

```bash
sudo docker stop webserver
```

---

## 📂 Désinstallation de Docker

### Arrêter Docker

```bash
sudo systemctl stop docker
```

### Supprimer les conteneurs, images et volumes

```bash
sudo docker system prune -a --volumes
```

### Désinstaller Docker

```bash
sudo apt purge -y docker-ce docker-ce-cli containerd.io
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
```

### Supprimer le dépôt Docker

```bash
sudo rm /etc/apt/sources.list.d/docker.list
```

---

## 🚨 Résolution des problèmes

### Erreur : "Permission denied"

Si vous voyez une erreur de permission, assurez-vous que votre utilisateur fait partie du groupe `docker` et que vous avez redémarré votre session.

### Erreur : "Cannot connect to the Docker daemon"

Vérifiez que Docker est en cours d'exécution :

```bash
sudo systemctl status docker
```

Si Docker n'est pas actif, démarrez-le :

```bash
sudo systemctl start docker
```

---

## 📚 Ressources utiles

- [Documentation officielle de Docker](https://docs.docker.com/)
- [Dépôt Docker pour Ubuntu](https://download.docker.com/linux/ubuntu/)
- [Guide de Docker Compose](https://docs.docker.com/compose/)

---

## 📝 Notes

- Docker nécessite un noyau Linux compatible (Ubuntu 20.04 utilise un noyau adapté).
- Pour une utilisation en production, envisagez de configurer un **firewall** (comme `ufw`) et de limiter les accès à Docker.
- Docker peut consommer beaucoup de ressources. Surveillez l'utilisation de la mémoire et du CPU.

---

## 💡 Conseils

- Utilisez **Docker Compose** pour gérer des applications multi-conteneurs.
- Explorez les images officielles sur [Docker Hub](https://hub.docker.com/).
- Pour des environnements de production, envisagez d'utiliser **Kubernetes** pour orchestrer vos conteneurs.

---

*Dernière mise à jour : 19 juin 2026*

[[plan_du_site|⟵ Retour au plan du site]]