diff --git a/README.org b/README.org
index 6c290e3..40afdd0 100644
--- a/README.org
+++ b/README.org
@@ -283,6 +283,18 @@ myc-update
 Cette commande va ré-appliquer l'installation du charm =docker-host=
 qui installe ou met à jour chaque composant.
 
+*** Mise à jour de docker
+
+Par défaut =myc-update= ne met pas à jour le service docker pour éviter
+de couper les services. Si cela est souhaité, il est possible de faire:
+
+#+begin_src sh
+ALLOW_DOCKER_CHANGE=1 myc-update
+#+end_src
+
+Aussi, par défaut, =myc-update= pré-selectionne une version cible commune de
+docker pour une distribution donnée.
+
 ** Gestion des dockers
 *** Relancement