diff --git a/docs/upgrades/migrate_docker2containerd.md b/docs/upgrades/migrate_docker2containerd.md
index 08b584a82a5a329ed6a50c255fd372eb0d992158..df2e06c8a8e1ba4c14d85b530b129e7abb5c557b 100644
--- a/docs/upgrades/migrate_docker2containerd.md
+++ b/docs/upgrades/migrate_docker2containerd.md
@@ -25,11 +25,15 @@ Everything done here requires full root access to every node.
 
 ## Migration steps
 
-Before you begin, adjust `k8s-cluster.yml` in your inventory.
+Before you begin, adjust your inventory:
 
 ```yaml
+# Filename: k8s_cluster/k8s-cluster.yml
 resolvconf_mode: host_resolvconf
 container_manager: containerd
+
+# Filename: etcd.yml
+etcd_deployment_type: host
 ```
 
 ### 1) Pick one or more nodes for processing
@@ -53,6 +57,12 @@ service docker stop
 apt-get remove -y --allow-change-held-packages containerd.io docker-ce docker-ce-cli docker-ce-rootless-extras
 ```
 
+In some cases, there might a `pigz` missing dependency. Some image layers need this to be extracted.
+
+```shell
+apt-get install pigz
+```
+
 ### 5) Run `cluster.yml` playbook with `--limit`
 
 ```commandline