Get Started/Getting Started
v3.5.44
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 | 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