diff --git a/docs/devcontainer/getting-started.md b/docs/devcontainer/getting-started.md
index d7fd23a273b..3a90d2b3d79 100644
--- a/docs/devcontainer/getting-started.md
+++ b/docs/devcontainer/getting-started.md
@@ -26,7 +26,8 @@ After installation, increase resources for better build performance:
 1. Open Rancher Desktop → Preferences → Virtual Machine
 2. **Memory**: Allocate as much as your system allows (leave ~4-8 GB for your host OS)
 3. **CPUs**: Allocate as many cores as possible (leave 1-2 for your host OS)
-4. Apply changes and restart Rancher Desktop
+4. **Disk**: Rancher Desktop doesn't have a UI for disk size. To increase it, see [Troubleshooting - Increase Docker disk allocation](./troubleshooting.md#build-fails-with-no-space-left-on-device) for instructions.
+5. Apply changes and restart Rancher Desktop
 
 > **Tip:** More resources = faster builds. MongoDB builds benefit significantly from additional CPU cores and memory.
 
diff --git a/docs/devcontainer/troubleshooting.md b/docs/devcontainer/troubleshooting.md
index 660610d708b..79d9eca35c2 100644
--- a/docs/devcontainer/troubleshooting.md
+++ b/docs/devcontainer/troubleshooting.md
@@ -54,8 +54,37 @@ Error: failed to solve: write /var/lib/docker/...: no space left on device
 
 2. **Increase Docker disk allocation:**
 
-   - **Docker Desktop/Rancher Desktop**: Settings → Resources → Disk
-   - Increase to at least 60 GB for comfortable MongoDB development
+   **Rancher Desktop:**
+
+   Rancher Desktop does not have a UI for increasing disk size. To increase it:
+
+   **On macOS or Linux:**
+
+   1. Stop Rancher Desktop completely
+   2. Create or edit the VM configuration file:
+      - **macOS**: `~/Library/Application Support/rancher-desktop/lima/_config/override.yaml`
+      - **Linux**: `~/.config/rancher-desktop/lima/_config/override.yaml`
+   3. Add or modify the disk size setting:
+      ```yaml
+      disk: 100GB
+      ```
+   4. Start Rancher Desktop
+   5. If Rancher Desktop was previously initialized, you may need to perform a factory reset (Preferences → Troubleshooting → Reset Kubernetes) for the disk size change to take effect.
+
+   **On Windows (WSL2):**
+
+   The disk is managed by WSL2:
+
+   1. Stop Rancher Desktop
+   2. Run: `wsl --shutdown`
+   3. Follow Microsoft's guide to increase WSL2 disk size: https://learn.microsoft.com/en-us/windows/wsl/disk-space
+
+   **Docker Desktop:**
+
+   1. Open Docker Desktop
+   2. Go to Settings → Resources → Disk image size
+   3. Increase to at least 60 GB (100+ GB recommended for MongoDB development)
+   4. Click "Apply & Restart"
 
 3. **Remove old dev containers:**