Files
quorum-test-network/URGENT_DOCKER_DNS_FIX.md
2026-02-09 21:51:48 -08:00

70 lines
2.0 KiB
Markdown

# ⚠️ URGENT: Docker Desktop DNS Configuration Required
## Problem
Docker Desktop is still using the old DNS server (10.0.2.3) which is timing out. The WSL2 DNS fix we applied helps the host, but **Docker Desktop runs in its own VM and needs separate DNS configuration**.
## Solution: Configure Docker Desktop DNS
### Step 1: Open Docker Desktop
1. Look for the Docker Desktop icon in your Windows system tray (bottom right)
2. Right-click and select "Settings" or open Docker Desktop
### Step 2: Navigate to Docker Engine Settings
1. In Docker Desktop, click the **Settings** (⚙️) icon in the top right
2. In the left sidebar, click **"Docker Engine"**
### Step 3: Add DNS Configuration
1. You'll see a JSON configuration editor
2. **Add or update** the `dns` field in the JSON:
**If the JSON is empty or minimal:**
```json
{
"dns": ["8.8.8.8", "8.8.4.4", "1.1.1.1"]
}
```
**If there's already content, add the dns line:**
```json
{
"builder": {
"gc": {
"enabled": true
}
},
"dns": ["8.8.8.8", "8.8.4.4", "1.1.1.1"],
"experimental": false
}
```
### Step 4: Apply and Restart
1. Click **"Apply & Restart"** button
2. Wait for Docker Desktop to restart (this takes 30-60 seconds)
### Step 5: Verify
After Docker Desktop restarts, test in WSL2:
```bash
cd /home/intlc/projects/quorum-test-network
docker pull alpine:latest
```
If this works, the DNS is fixed!
## Alternative: Restart WSL
If you can't access Docker Desktop settings right now:
1. From Windows PowerShell (as Administrator):
```powershell
wsl --shutdown
```
2. Restart your WSL terminal
3. Try the network again
## Quick Reference
- **Docker Desktop Settings Location**: Settings → Docker Engine
- **DNS Servers to Add**: `["8.8.8.8", "8.8.4.4", "1.1.1.1"]`
- **After Configuration**: Click "Apply & Restart"
## Why This is Needed
Docker Desktop runs in a separate VM from WSL2. The DNS configuration we applied to WSL2 doesn't automatically apply to Docker Desktop's VM. Docker Desktop needs its own DNS configuration.