WikiDNS 12.0.0

About WikiDNS

WikiDNS is a lightweight DNS server and zone management system written in Python 3. It stores DNS records in JSON format, making domain management transparent, version-controllable, and human-readable.

The project also includes an NSS module for GNU/Linux integration.

Mailing List

wikidns-announce@aamot.org – Project Announcements

Download

• wikidns-12.0.0.tar.gz
• wikidns-12.0.0.tar.xz
• wikidns-12.0.0.zip

Program Files

• wikidns-server.py – Core DNS server
• wikidns-client.py – Client for querying WikiDNS
• wikidns-domain.py – Domain record management
• wikidns-update.py – Update DNS records
• wikidns-zonetool.py – Zone inspection and validation
• wikidns-resolve-dns-internet.py – Internet DNS resolver helper
• libnss_wikidns.c – GNU/Linux NSS integration module
• Makefile – Build configuration

Documentation

• User Manual (PDF)
• User Manual (ODT)

Installation

Requirements

• Python 3.8 or newer
• GNU/Linux (recommended)
• Optional: GCC for NSS module

Extract

tar -xvf wikidns-12.0.0.tar.gz
cd wikidns-12.0.0

Run Server

python3 wikidns-server.py

Query Using Client

python3 wikidns-client.py example.com

Build NSS Module

make
sudo make install

After installation, edit /etc/nsswitch.conf and add:

hosts: files wikidns dns

Example JSON Zone File

sudo nano /etc/wikidns.json

{"domain_name": "aamot.org", "dns_records": {"A": ["91.229.143.159"]}}

License

WikiDNS is released as Free Software. You are free to use, modify, and distribute it.

Author

Ole Kristian Aamot
Aamot Engineering / Aamot Research
https://aamot.io/