diff --git a/docs/developer/developer-mode-installation.md b/docs/developer/developer-mode-installation.md
index 2b631a759ef..92446183251 100644
--- a/docs/developer/developer-mode-installation.md
+++ b/docs/developer/developer-mode-installation.md
@@ -58,16 +58,20 @@ You can install Harvester on an [RKE2](https://docs.rke2.io/) cluster using the
     sudo cp /etc/rancher/rke2/rke2.yaml ~/.kube/config
     sudo chown $(id -u):$(id -g) ~/.kube/config
     ```
+    
+    :::info important
+
+    Allow some time for all pods in the `kube-system` namespace to reach the `Ready` state before proceeding to the next step.
+
+    If you are unable to locate the kubectl binary in `/usr/local/bin`, check `/var/lib/rancher/rke2/bin`.
+
+    :::
 
 1. Install system-upgrade-controller. This Kubernetes-native upgrade controller for nodes installs `upgrade.cattle.io/v1` CRDs.
     ```bash
     kubectl apply -f https://github.com/rancher/system-upgrade-controller/releases/download/v0.13.1/system-upgrade-controller.yaml
     ```
 
-:::info note
-If you are unable to locate the `kubectl` binary in `/usr/local/bin`, check `/var/lib/rancher/rke2/bin`.
-:::
-
 1. Create the cattle-system namespace.
     ```bash
     kubectl create ns cattle-system
@@ -92,6 +96,12 @@ If you are unable to locate the `kubectl` binary in `/usr/local/bin`, check `/va
     --set bootstrapPassword=admin
     ```
 
+    :::info important
+
+    Allow some time for all pods in the `cattle-system` namespace to reach the `Ready` state before proceeding to the next step.
+
+    :::
+
 1. Clone the `rancher/charts` repository.
     ```bash
     git clone https://github.com/rancher/charts -b dev-v2.7
diff --git a/versioned_docs/version-v1.3/developer/developer-mode-installation.md b/versioned_docs/version-v1.3/developer/developer-mode-installation.md
index 2b631a759ef..1baf5407d87 100644
--- a/versioned_docs/version-v1.3/developer/developer-mode-installation.md
+++ b/versioned_docs/version-v1.3/developer/developer-mode-installation.md
@@ -59,15 +59,19 @@ You can install Harvester on an [RKE2](https://docs.rke2.io/) cluster using the
     sudo chown $(id -u):$(id -g) ~/.kube/config
     ```
 
+    :::info important
+
+    Allow some time for all pods in the `kube-system` namespace to reach the `Ready` state before proceeding to the next step.
+
+    If you are unable to locate the kubectl binary in `/usr/local/bin`, check `/var/lib/rancher/rke2/bin`.
+
+    :::
+
 1. Install system-upgrade-controller. This Kubernetes-native upgrade controller for nodes installs `upgrade.cattle.io/v1` CRDs.
     ```bash
     kubectl apply -f https://github.com/rancher/system-upgrade-controller/releases/download/v0.13.1/system-upgrade-controller.yaml
     ```
 
-:::info note
-If you are unable to locate the `kubectl` binary in `/usr/local/bin`, check `/var/lib/rancher/rke2/bin`.
-:::
-
 1. Create the cattle-system namespace.
     ```bash
     kubectl create ns cattle-system
@@ -92,6 +96,12 @@ If you are unable to locate the `kubectl` binary in `/usr/local/bin`, check `/va
     --set bootstrapPassword=admin
     ```
 
+    :::info important
+
+    Allow some time for all pods in the `cattle-system` namespace to reach the `Ready` state before proceeding to the next step.
+
+    :::
+
 1. Clone the `rancher/charts` repository.
     ```bash
     git clone https://github.com/rancher/charts -b dev-v2.7