Installation

Install DNS-MNS on Windows, macOS, or Linux

Installation

DNS-MNS can be installed on Windows, macOS, and Linux. Choose the method that works best for you.

Pre-Built Binary (Recommended)

The easiest way to use DNS-MNS is to download the pre-built binary. No dependencies required — just download and run.

This is the best option for users in Iran who cannot use curl or wget due to network restrictions. Just get the binary file and run it. No internet connection needed after download.

1. Go to the Releases page
2. Download the binary for your system:

Platform	File
Windows (64-bit)	dns-mns-windows-amd64.exe
macOS (Intel)	dns-mns-darwin-amd64
macOS (Apple Silicon)	dns-mns-darwin-arm64
Linux (x86_64)	dns-mns-linux-amd64
Linux (ARM64)	dns-mns-linux-arm64

3. Run it:

Linux/macOS

chmod +x dns-mns-linux-amd64
./dns-mns-linux-amd64

Windows

Double-click dns-mns-windows-amd64.exe or run from Command Prompt/PowerShell.

Right-click and select “Run as administrator” to enable DNS configuration.

One-Line Install

Install DNS-MNS with a single command. The installer automatically detects your OS and architecture, then downloads the correct pre-built binary.

curl

curl -sSL https://gitlab.com/E-Gurl/dns-mns/-/raw/main/install.sh | bash

wget

wget -qO- https://gitlab.com/E-Gurl/dns-mns/-/raw/main/install.sh | bash

The installer will:

• Detect your OS (Linux, macOS, Windows) and architecture (x86_64, ARM64)
• Download the correct pre-built binary (same as the manual download — no dependencies)
• Install it to ~/.local/bin/dns-mns
• Add it to your PATH (you may need to restart your terminal)

Manual Installation

If you cannot or do not want to use curl/wget, you can install manually.

Option A: Download ZIP

1. Go to gitlab.com/E-Gurl/dns-mns
2. Click the Code button, then click Download ZIP
3. Extract the ZIP file to a folder on your computer
4. Open a terminal and navigate to that folder:

cd /path/to/dns-mns
chmod +x dns-mns.sh
./dns-mns.sh

Option B: Clone with Git

git clone https://gitlab.com/E-Gurl/dns-mns.git
cd dns-mns
chmod +x dns-mns.sh
./dns-mns.sh

Building from Source

If you want to build the Go binary yourself:

1. Install Go (1.21 or newer)
2. Clone and build:

git clone https://gitlab.com/E-Gurl/dns-mns.git
cd dns-mns
go build -ldflags="-s -w" -o dns-mns ./cmd/dns-mns/

Cross-compile for other platforms:

# Windows
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o dns-mns.exe ./cmd/dns-mns/

# macOS (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -ldflags="-s -w" -o dns-mns-mac ./cmd/dns-mns/

Platform-Specific Requirements

The pre-built binary has no dependencies. The requirements below apply only to the shell script version.

Linux

Most Linux systems have everything needed. If not, install these:

Ubuntu/Debian:

sudo apt update
sudo apt install curl ping gawk

Fedora:

sudo dnf install curl iputils gawk

Arch Linux:

sudo pacman -S curl iputils gawk

macOS

macOS has all required tools pre-installed. No additional installation needed.

Windows

For the shell script, you need one of these:

Option A: Git Bash (Recommended)

1. Download Git for Windows from git-scm.com/download/win
2. Install it (Git Bash is included)
3. Open Git Bash and run the installation command

Option B: WSL (Windows Subsystem for Linux)

1. Open PowerShell as Administrator
2. Run: wsl --install
3. Restart your computer
4. Open Ubuntu from Start Menu
5. Follow the Linux instructions above

The pre-built .exe binary runs natively on Windows — no Git Bash or WSL needed.

Updating to a Newer Version

Auto-Update (Recommended)

The easiest way to update — the binary updates itself:

dns-mns update

Re-run Installer

Re-run the one-line installer to download and install the latest binary:

curl -sSL https://gitlab.com/E-Gurl/dns-mns/-/raw/main/install.sh | bash

Manual Download

1. Go to the Releases page
2. Download the binary for your platform
3. Replace your existing binary (e.g., ~/.local/bin/dns-mns)
4. Make sure it’s executable: chmod +x dns-mns

Git (Build from Source)

cd /path/to/dns-mns
git pull origin main
go build -ldflags="-s -w" -o dns-mns ./cmd/dns-mns/

Uninstalling

Binary (installed via download or one-line installer):

rm -f ~/.local/bin/dns-mns

Legacy shell script (if previously installed):

rm -rf ~/.dns-mns
rm -f ~/.local/bin/dns-mns

Verifying Installation

After installation, verify that DNS-MNS is working:

dns-mns

You should see the main menu:

[ MAIN MENU ]

  [1]  Test Gaming DNS
  [2]  Set Custom DNS
  [3]  Clear/Reset DNS
  [4]  Test DoH/DoT DNS
  [5]  Help & About
  [6]  Test DNSCrypt
  [7]  DNSCrypt Proxy
  [8]  DoH/DoT Proxy
  [9]  DNS Censorship Check
  [10] Smart Proxy (Auto-Fallback)
  [0]  Exit

Enter your choice [0-10]:

If you see “Command not found: dns-mns”, try restarting your terminal or run directly: ~/.local/bin/dns-mns