Get Started/Getting Started
v7.27.75
Get Started

Getting Started

5 minute setup

A step-by-step onboarding guide to get NexoralDNS running on your network in about five minutes.

Prerequisites

✓Linux, macOS, or Windows — any OS that runs Docker
✓2GB+ RAM recommended (minimum)
✓Terminal / shell access to run commands
✓Network access with LAN connectivity
ℹ️
Docker is handled for you
Docker will be installed automatically if it is not already present on your system.

Setup in four steps

1

Install NexoralDNS

Run the one-command installer. This downloads and starts all required services automatically.

bash
$ curl -fsSL https://raw.githubusercontent.com/nexoral/NexoralDNS/main/Scripts/install.sh | sudo bash -
2

Access the dashboard

Once services are up, open the web dashboard in your browser.

▸From this machine — http://localhost:4000
▸From other devices — http://192.168.x.x:4000
3

Configure your router

Point your network at NexoralDNS so every device benefits.

▸Log into your router admin panel (usually 192.168.1.1 or 192.168.0.1)
▸Find DNS settings under LAN, DHCP, or Network
▸Set Primary DNS to your NexoralDNS server IP
▸Save and restart your router
4

Create your first custom domain

In the dashboard, go to Domains → Add Domain.

▸Enter domain — myserver.local
▸Point to IP — 192.168.1.100
▸Now try pinging myserver.local from any device!
✅
Congratulations!
NexoralDNS is now managing your network's DNS. All queries from your devices will be logged, cached, and fully customizable from the dashboard.

What's next

Continue exploring