⏱ī¸5 minute setup

Getting Started

Get NexoralDNS up and running in just a few minutes. Follow these simple steps to take control of your network's DNS.

📋Prerequisites

✓
Linux, macOS, or Windows- Any OS that runs Docker
✓
2GB+ RAM- Recommended minimum
✓
Terminal/Shell access- To run commands
✓
Network access- LAN connectivity

Docker will be installed automatically if not present on your system.

1

Install NexoralDNS

Run the one-line installer to set up NexoralDNS on your machine. The script will automatically install Docker if needed.

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

This will download and start all required services automatically.

2

Access the Dashboard

Open your browser and navigate to the NexoralDNS dashboard to start configuring your DNS server.

Dashboard URL:

http://localhost:4000

Or use your machine's IP address to access from other devices: http://192.168.x.x:4000

3

Configure Your Router

Point your router's DNS settings to your NexoralDNS server to enable network-wide DNS management.

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

Alternatively, you can configure individual devices to use NexoralDNS in their network settings.

4

Create Your First Custom Domain

Test your setup by creating a custom domain that points to a device on your network.

In the dashboard:

  1. →Go to Domains section
  2. →Click Add Domain
  3. →Enter domain: myserver.local
  4. →Point to IP: 192.168.1.100

Now try pinging myserver.local from any device on your network!

🎉

You're All Set!

Congratulations! NexoralDNS is now managing your network's DNS. All DNS queries from your devices will now be logged, cached, and can be customized from the dashboard.

Explore Dashboard →View All Features