> ## Documentation Index
> Fetch the complete documentation index at: https://e-gurl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get up and running with DNS-MNS in under 5 minutes

# 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](https://gitlab.com/E-Gurl/dns-mns/-/releases) and download the binary for your platform. Then make it executable and run it:

```bash theme={null}
chmod +x dns-mns-linux-amd64
./dns-mns-linux-amd64
```

On Windows, just double-click the `.exe` file.

**Option B: One-line install**

```bash theme={null}
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:

```bash theme={null}
dns-mns
```

If using the binary directly, run it from wherever you downloaded it.

You'll see the main menu:

```
【 MAIN MENU 】

  [1]  Test & Benchmark DNS
  [2]  Set / Reset DNS
  [3]  Encrypted DNS
  [4]  Security & Privacy
  [5]  Smart Proxy (Auto-Fallback)
  [6]  Live Dashboard
  [7]  Smart Recommend
  [8]  Advanced Evasion Suite
  [9]  Help & About
  [10] DNS Leak Test Dashboard
  [11] Passwall Integration
  [12] MikroTik Integration
  [0]  Exit
```

## 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
```

<Tip>
  **For Iranian users:** Start with option `2` (Regional/Middle East DNS) or option `3` (Gaming Optimized DNS) for best results.
</Tip>

## 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
```

<Note>
  The tool will request administrator/sudo privileges to change your DNS settings.
</Note>

## Step 7: Verify It's Working

After applying, test your connection:

```bash theme={null}
ping google.com
```

If you're getting responses, you're all set.

## Step 8: Encrypted DNS and Tunnel Workflows

For enhanced privacy and censorship resilience:

* Main Menu → **\[3] Encrypted DNS** for DoH/DoT/DNSCrypt tests and local encrypted proxy controls
* Main Menu → **\[8] Advanced Evasion Suite** for sing-box protocols and **Tunnel Suite** workflows (DNSTT/Slipstream/Paqet)

**What are 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

Encrypted DNS menu actions include provider testing, DoH health checks, and starting/stopping local DoH/DoT or DNSCrypt proxy services.

Advanced Evasion menu includes **Tunnel Suite** for profile-based tunnel operations:

* profile create/list/select/import/export
* start/stop/status/logs
* resolver scan and health checks

These protocols can help bypass DNS filtering and blocking, which is particularly useful in regions with internet restrictions.

<Note>
  The tool tests 28+ DoH/DoT providers including international (Cloudflare, Google, Quad9, NextDNS, RethinkDNS) and regional (Shecan, Electro, RadarGame) options, plus DNSCrypt providers.
</Note>

## 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

<CardGroup cols={2}>
  <Card title="DNS Testing" icon="flask" href="/usage/testing-dns">
    Learn about the DNS testing algorithms
  </Card>

  <Card title="Setting DNS" icon="gear" href="/usage/setting-dns">
    Understand how DNS is configured on each platform
  </Card>

  <Card title="DNS Servers" icon="server" href="/reference/dns-servers">
    Browse all 375+ DNS servers available
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/reference/troubleshooting">
    Fix common issues
  </Card>
</CardGroup>