SERVER-112513: Provide better instructions for increasing the disk size of the rancher desktop VM (#42967)

GitOrigin-RevId: 939b0ed376f0938bdaa5718fc96c7ebfd948424f
This commit is contained in:
Eric Lavigne 2025-10-27 10:07:56 -06:00 committed by MongoDB Bot
parent 55bc36a85b
commit 3da86574b4
2 changed files with 33 additions and 3 deletions

View File

@ -26,7 +26,8 @@ After installation, increase resources for better build performance:
1. Open Rancher Desktop → Preferences → Virtual Machine 1. Open Rancher Desktop → Preferences → Virtual Machine
2. **Memory**: Allocate as much as your system allows (leave ~4-8 GB for your host OS) 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) 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. > **Tip:** More resources = faster builds. MongoDB builds benefit significantly from additional CPU cores and memory.

View File

@ -54,8 +54,37 @@ Error: failed to solve: write /var/lib/docker/...: no space left on device
2. **Increase Docker disk allocation:** 2. **Increase Docker disk allocation:**
- **Docker Desktop/Rancher Desktop**: Settings → Resources → Disk **Rancher Desktop:**
- Increase to at least 60 GB for comfortable MongoDB development
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:** 3. **Remove old dev containers:**