Files
proxmox/docs/04-configuration/FIX_LOCAL_DNS_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

2.2 KiB

Fix Local DNS — Complete Guide

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


Issue: DNS_PROBE_FINISHED_NXDOMAIN for explorer.d-bis.org, explorer.defi-oracle.io, and all endpoints.

Cause: Your device/network DNS (ISP, router, or cached) is not resolving these domains. Cloudflare and Google DNS resolve them correctly.


Quick Fix (Run This)

sudo ./scripts/fix-local-dns-hosts.sh

This will:

  1. Add 21 domain entries to /etc/hosts → 76.53.10.36
  2. (WSL) Set /etc/resolv.conf to use Cloudflare DNS (1.1.1.1, 1.0.0.1)
  3. (WSL) Add generateResolvConf = false to /etc/wsl.conf so DNS persists

Note: If you can't use sudo, run without it to see the hosts entries — then add them manually with sudo nano /etc/hosts.


Domains Added

Domain Purpose
explorer.d-bis.org Blockscout explorer
explorer.defi-oracle.io Explorer (alias)
rpc-http-pub.d-bis.org RPC HTTP
rpc-ws-pub.d-bis.org RPC WebSocket
rpc.d-bis.org, rpc2.d-bis.org RPC aliases
ws.rpc.d-bis.org, ws.rpc2.d-bis.org WebSocket aliases
rpc-http-prv.d-bis.org, rpc-ws-prv.d-bis.org Private RPC
dbis-admin.d-bis.org, dbis-api.d-bis.org, etc. DBIS services
mim4u.org, secure.mim4u.org, training.mim4u.org MIM4U sites
rpc.public-0138.defi-oracle.io, rpc.defi-oracle.io, wss.defi-oracle.io Defi Oracle RPC

Verify

# Should return 76.53.10.36
getent hosts explorer.d-bis.org

# Should return HTTP 200
curl -sI https://explorer.d-bis.org/ | head -3

Alternative: Force Cloudflare DNS (No hosts file)

WSL — Create /etc/wsl.conf:

[network]
generateResolvConf = false

Then set /etc/resolv.conf:

nameserver 1.1.1.1
nameserver 1.0.0.1

Restart WSL: wsl --shutdown (from PowerShell), then reopen your terminal.


Other Devices (Mobile, Windows, Mac)

  • Windows: Settings → Network → DNS → Manual → 1.1.1.1, 1.0.0.1
  • Mac: System Settings → Wi-Fi → Details → DNS → Add 1.1.1.1
  • iPhone: Settings → Wi-Fi → (i) → Configure DNS → Manual → 1.1.1.1
  • Android: Settings → Private DNS → dns.cloudflare.com

Last updated: 2026-01-31