Skip to main content

Quick Start

This guide will help you find and configure the fastest DNS servers for your connection in just a few steps.

Step 1: Install DNS-MNS

Option A: Download the binary (Recommended) Go to the Releases page and download the binary for your platform. Then make it executable and run it:
chmod +x dns-mns-linux-amd64
./dns-mns-linux-amd64
On Windows, just double-click the .exe file. Option B: One-line install
curl -sSL https://gitlab.com/E-Gurl/dns-mns/-/raw/main/install.sh | bash
This automatically detects your OS and architecture and installs the correct binary.

Step 2: Launch the Tool

After installation, run:
dns-mns
If using the binary directly, run it from wherever you downloaded it. You’ll see the main menu:
[ MAIN MENU ]

  [1]  Test Gaming DNS
       Test all DNS servers and find the top 3 best for gaming

  [2]  Set Custom DNS
       Manually configure DNS server of your choice

  [3]  Clear/Reset DNS
       Reset DNS settings to automatic (DHCP default)

  [4]  Test DoH/DoT DNS
       Test encrypted DNS (DNS over HTTPS/TLS)

  [5]  Help & About
       Learn more about DNS-MNS

  [6]  Test DNSCrypt
       Test encrypted DNS (DNSCrypt protocol)

  [7]  DNSCrypt Proxy
       Start a local DNSCrypt proxy

  [8]  DoH/DoT Proxy
       Start a local DoH or DoT encrypted proxy

  [9]  DNS Censorship Check
       Detect DNS poisoning, hijacking, and blocking

  [10] Smart Proxy (Auto-Fallback)
       Resilient encrypted DNS proxy with auto protocol switching

  [0]  Exit
       Quit the application

Enter your choice [0-10]:

Step 3: Test DNS Servers

Press 1 to test DNS servers. You’ll see a category selection menu:
Select DNS category to test:

  [1] International Gaming DNS
  [2] Regional/Middle East DNS
  [3] Gaming Optimized DNS
  [4] VPN/Privacy DNS
  [5] Additional Iranian DNS
  [6] Test ALL DNS Servers

  [0] Back to Main Menu
For Iranian users: Start with option 2 (Regional/Middle East DNS) or option 3 (Gaming Optimized DNS) for best results.

Step 4: Wait for Results

The tool will test each DNS server and show a progress bar:
Testing DNS servers...
[████████████████████████░░░░░░░░░░░░░░░░] 60%
Testing takes 1-5 minutes depending on how many servers you selected.

Step 5: View Top Results

After testing completes, you’ll see the top 3 DNS servers:
TOP 3 DNS SERVERS

#1 Shecan
   Location: Iran
   Primary:   178.22.122.100
   Secondary: 185.51.200.2
   Ping: 15ms (Excellent)

#2 Electro
   Location: Iran
   Primary:   37.152.182.112
   Secondary: 37.152.182.113
   Ping: 18ms (Excellent)

#3 Cloudflare
   Location: Global
   Primary:   1.1.1.1
   Secondary: 1.0.0.1
   Ping: 25ms (Good)

Step 6: Apply the Best DNS

The tool will ask if you want to apply one of the top DNS servers:
Would you like to apply one of these DNS servers? (y/n): y
Enter selection (1-3): 1
The tool will request administrator/sudo privileges to change your DNS settings.

Step 7: Verify It’s Working

After applying, test your connection:
ping google.com
If you’re getting responses, you’re all set.

Testing Encrypted DNS (DoH/DoT/DNSCrypt)

For enhanced privacy and to bypass DNS-based censorship, test encrypted DNS providers:
[ MAIN MENU ]

  [4] Test DoH/DoT DNS
      Test encrypted DNS (DNS over HTTPS/TLS)

  [6] Test DNSCrypt
      Test DNSCrypt providers for encrypted DNS

  [7] Start DNSCrypt Proxy
      Run a local DNSCrypt proxy server
What is DoH/DoT/DNSCrypt?
  • DNS over HTTPS (DoH): Encrypts DNS queries using HTTPS (port 443)
  • DNS over TLS (DoT): Encrypts DNS queries using TLS (port 853)
  • DNSCrypt: Encrypts and authenticates DNS traffic between client and resolver using the DNSCrypt protocol
Option [6] tests available DNSCrypt providers for reachability and response time. Option [7] starts a local DNSCrypt proxy that forwards your DNS queries through an encrypted DNSCrypt connection. These protocols can help bypass DNS filtering and blocking, which is particularly useful in regions with internet restrictions.
The tool tests 28+ DoH/DoT providers including international (Cloudflare, Google, Quad9, NextDNS, RethinkDNS) and regional (Shecan, Electro, RadarGame) options, plus DNSCrypt providers.

Resetting DNS

If you want to go back to your default DNS settings, run dns-mns and select option 3 from the main menu. This resets your DNS to automatic (DHCP), meaning your router/ISP will provide DNS servers again.

Next Steps