⚠️ 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

Look for the Docker Desktop icon in your Windows system tray (bottom right)
Right-click and select "Settings" or open Docker Desktop

Step 2: Navigate to Docker Engine Settings

In Docker Desktop, click the Settings (⚙️) icon in the top right
In the left sidebar, click "Docker Engine"

Step 3: Add DNS Configuration

You'll see a JSON configuration editor
Add or update the dns field in the JSON:

If the JSON is empty or minimal:

{
  "dns": ["8.8.8.8", "8.8.4.4", "1.1.1.1"]
}

If there's already content, add the dns line:

{
  "builder": {
    "gc": {
      "enabled": true
    }
  },
  "dns": ["8.8.8.8", "8.8.4.4", "1.1.1.1"],
  "experimental": false
}

Step 4: Apply and Restart

Click "Apply & Restart" button
Wait for Docker Desktop to restart (this takes 30-60 seconds)

Step 5: Verify

After Docker Desktop restarts, test in WSL2:

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:

From Windows PowerShell (as Administrator):
```
wsl --shutdown
```
Restart your WSL terminal
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.

2.0 KiB Raw Blame History