Help
Troubleshooting
A comprehensive reference for installation, DNS, dashboard, performance and database issues.
Quick diagnostics
sudo docker compose ps
sudo docker compose logs -f
sudo docker compose logs -f dns-server
cat VERSION
Port conflicts
"Port 53 already in use" or "Port 4000 already in use".
sudo netstat -tulpn | grep :53
sudo systemctl disable systemd-resolved
sudo systemctl stop systemd-resolved
sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
DNS not working after installation
sudo docker compose ps
dig @localhost google.com
sudo ufw allow 53/udp
sudo ufw allow 53/tcp
sudo ufw allow 4000/tcp
Custom domains not resolving
docker exec -it nexoraldns-redis-1 redis-cli FLUSHDB
dig @localhost myapp.local
dig @192.168.1.100 myapp.local
Cannot access the dashboard
sudo docker compose ps | grep web
sudo docker compose restart web
curl http://localhost:4000
Login issues / forgot password
Default credentials are admin / admin. Reset via MongoDB if needed:
docker exec -it nexoraldns-mongodb-1 mongosh
use nexoraldns
db.users.updateOne({ username: "admin" }, { $set: { password: "$2b$10$..." } })Common error messages
MessageMeaning
Port already in useAnother service is using port 53 or 4000
Connection refusedService not running — check status and restart
NXDOMAINDomain not found or blocked
Permission deniedInsufficient privileges — use sudo
Network unreachableNo internet — check connectivity
Useful commands
docker compose ps # service status
docker compose logs -f # all logs
docker compose restart # restart all
docker stats # resource usage
dig @localhost domain.com # test resolution
ℹ️Still need help?
Check GitHub Issues, open a new issue with your OS / Docker version / logs, or contact priority support (premium).