{{tag>sysadmin docker root directory racine}}

====== Modifier le root applicatif du service Docker ======

Par défaut Docker stocke l'ensemble des données dans le répertoire ''/var/lib/docker''. Comme il contient à la fois les images et les volumes nommés, sa taille peut rapidement augmenter.


===== Migration du root applicatif =====

Arrêter le service:
<code bash>
systemctl stop docker.service
</code>

Redéfinir la configuration par défaut via le fichier ''**/etc/docker/daemon.json**''

Afficher la version du daemon docker:
<code bash>
/usr/bin/dockerd --version
</code>

Pour les version antérieures à 17.05.0, utiliser la variable ''**graph**''
<file json>
{ 
   "graph": "/path/to/your/new/docker/root" 
}
</file>

Pour les versions 17.05.0 et supérieure, même si ''**graph**'' est encore disponible la documentation recommande l'usage de la variable plus explicite ''**data-root**''

<file json>
{ 
   "data-root": "/path/to/new/docker/daemon-data-root"
}
</file>

Créer la nouvelle racine si besoin et copier l'ancien répertoire racine du service vers la nouvelle destination
<code bash>
sudo mkdir -p "/path/to/new/docker/daemon-data-root"
chmod 750 "/path/to/new/docker/daemon-data-root"

# via cp
sudo cp -rp /var/lib/docker/* "/path/to/new/docker/daemon-data-root"

# équivalent via rsync
sudo rsync -aP /var/lib/docker/ "/path/to/new/docker/daemon-data-root"
</code>

===== Test de la nouvelle configuration =====

Renommer l'ancienne racine du service pour s'assurer que le daemon ne l'utilise plus:
<code bash>
sudo mv /var/lib/docker /var/lib/docker.bak
</code>

Redémarrer le service et vérifier la présence des images, des volumes et des conteneurs:
<code bash>
sudo systemctl start docker.service

docker images

docker volume list

docker container list -a
</code>

Si tout est normal, on peut supprimer le dossier /var/lib/docker.bak et son contenu:
<code bash>
sudo rm -fr /var/lib/docker.bak 
</code>

===== Références =====

  * https://tienbm90.medium.com/how-to-change-docker-root-data-directory-89a39be1a70b