Installation

Install DNS-MNS on Windows, macOS, Linux, OpenWrt, or Android

Installation

DNS-MNS can be installed on Windows, macOS, Linux, OpenWrt, and Android. 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

Option 1: Use the PowerShell Wrapper (Recommended)

Download both files from the releases page:

• dns-mns-windows-amd64.exe
• dns-mns-wrapper.ps1

Place them in the same folder and run:

.\dns-mns-wrapper.ps1

The wrapper automatically handles Administrator privileges.

Option 2: Run Directly

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. Find the binary for your platform in the extracted folder and run it:

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

Option B: Clone with Git

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

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/

# OpenWrt (statically linked)
make build-openwrt

OpenWrt Router Installation

DNS-MNS can run directly on OpenWrt routers, providing smart DNS for your entire network.

Supported Architectures

Architecture	Download File
x86_64	dns-mns-openwrt-x86_64
MIPS	dns-mns-openwrt-mips
MIPSel	dns-mns-openwrt-mipsel
ARM v7	dns-mns-openwrt-armv7
ARM64	dns-mns-openwrt-aarch64

Installation Steps

1. Identify your router architecture:

   ssh root@192.168.1.1
   uname -m
   

2. Download and install:

   # From your computer, copy the binary to router
   scp dns-mns-openwrt-x86_64 root@192.168.1.1:/tmp/
   
   # SSH to router and install
   ssh root@192.168.1.1
   mv /tmp/dns-mns-openwrt-x86_64 /usr/bin/dns-mns
   chmod +x /usr/bin/dns-mns
   

3. Configure DNS-MNS:

   # Detect OpenWrt
   dns-mns openwrt detect
   
   # Setup (upstream mode recommended)
   dns-mns openwrt setup --mode upstream
   
   # Check status
   dns-mns openwrt status
   

4. Enable auto-start:

   /etc/init.d/dns-mns enable
   /etc/init.d/dns-mns start
   

See the OpenWrt Guide for detailed configuration options.

Platform-Specific Requirements

The pre-built binary has no dependencies. Just download and run it.

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

The pre-built .exe binary runs natively on Windows. No additional tools 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/

Android (Beta)

Android support is in beta (v0.0.4-beta). Expect rough edges. Feedback and bug reports are welcome.

DNS-MNS is available as a standalone APK for Android devices. No Play Store required.

Supported Architectures

Architecture	Devices
arm64-v8a	Most modern phones (Pixel, Samsung Galaxy S/A series, etc.)
armeabi-v7a	Older 32-bit ARM devices
x86_64	Android emulators, ChromeOS
x86	Older Intel-based tablets

The universal APK includes all four architectures — one download works on all supported devices. Platform-specific APKs are also available for smaller download sizes.

Installation Steps

1. Download the APK from the Releases page:
   • Universal: dns-mns-android-0.0.4-beta.apk (all architectures)
   • Per-ABI: dns-mns-android-arm64-v8a-0.0.4-beta.apk, dns-mns-android-armeabi-v7a-0.0.4-beta.apk, dns-mns-android-x86_64-0.0.4-beta.apk, dns-mns-android-x86-0.0.4-beta.apk
2. On your Android device, enable Install from unknown sources:
   • Android 8+: Settings > Apps > Special access > Install unknown apps
   • Older: Settings > Security > Unknown sources
3. Open the APK file and tap Install
4. Open DNS-MNS from the app drawer

Features

• VPN-based DNS tunnel — routes DNS queries through a local VPN for system-wide coverage
• One-tap configuration — tap Connect to start, tap Disconnect to stop
• Light/dark mode — toggle between themes with persistent preference

The Android app does not require root access. It uses Android’s VPN API to intercept and route DNS traffic.

Uninstalling

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

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