namedot

Lightweight GeoDNS server with REST API, Web Admin Panel, and Master-Slave replication.

Features

• DNS Server: UDP/TCP DNS server with DNSSEC support
• GeoDNS: Geographic routing based on country, continent, or subnet
• REST API: Full API for zone and record management
• Web Admin: User-friendly web interface for DNS management
• Replication: Master-Slave replication for high availability
• Multiple Backends: SQLite, PostgreSQL, MySQL support
• HTTPS Support: TLS/SSL with automatic certificate reloading
• Access Control: IP-based CIDR whitelisting for REST API

Quick Start

# Install from package (Debian/Ubuntu)
sudo dpkg -i namedot_*.deb

# Or build from source
make build

# Generate API token hash
./namedot -g mytoken

# Start server
./namedot -c config.yaml

Documentation

📚 Full documentation is available in the docs directory:

• Full README - Complete documentation
• Replication Guide - Master-Slave setup
• Web Admin Guide - Web interface documentation
• Docker Guide - Docker deployment
• Package Guide - Installation from packages
• Configuration Examples - Sample configurations

Configuration Examples

After installation, configuration examples are available in:

• Source: ./docs/examples/
• Installed package: /usr/share/doc/namedot/examples/

Available examples:

• config.yaml - Basic configuration
• config.master.yaml - Master replication setup
• config.slave.yaml - Slave replication setup
• config.mysql.yaml - MySQL backend
• config.postgres.yaml - PostgreSQL backend
• config.docker.yaml - Docker environment

License

MIT License - see LICENSE file for details.

Author

Sergei Vorontsov piligrim@rootnix.net

Repository

https://github.com/foxzi/namedot