Commands

Install

The one-command installer — handles Docker setup and first boot.

Command

install

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

What it does

▸Verifies system compatibility (Linux Debian/Ubuntu)

▸Installs Docker and Docker Compose if needed

▸Downloads the repository and pulls the latest images

▸Configures system DNS and starts all containers

▸Verifies installation and shows access info

Expected output

console

[✓] System compatibility check passed
[✓] Docker installed successfully
[✓] Services started successfully
[✓] DNS configuration updated
Installation complete!
Access the dashboard at: http://localhost:4000
Default credentials: admin / admin

⚠️

Change the default password

Change admin / admin immediately after first login at Settings → Change Password.

Troubleshooting

fixes

# permission denied
sudo curl -fsSL https://raw.githubusercontent.com/nexoral/NexoralDNS/main/Scripts/install.sh | sudo bash -
# port 53 in use
sudo systemctl disable systemd-resolved
sudo systemctl stop systemd-resolved