Skip to main content
Help us improve Python packaging – donate today!

micro dns server

Project Description

'Stories in Ready' Build Status Coverage Quality

udns is an authoritative, caching DNS server for development and small deployments written in Python using the circuits Application Framework and the dnslib DNS library. udns can be run standalone, via Docker or using the Docker Compose tool. udns is designed to be small, lightweight, fast and flexible. udns fully supports forwarding, caching as well as honoring TTL(s). udns will also read your /etc/hosts file at startup and use this to populate an internal hosts cache so that entries in your local /etc/hosts file are fully resolvable with tools such as host, dig and resolver client libraries.

Installation and Usage

From Source:

$ git clone
$ cd udns
$ python develop
$ sudo udnsd --debug  # Server
$ udnsc --help        # Client

From Source using Docker and Docker Compose:

$ git clone
$ cd udns
$ docker-compose up -d                  # Server
$ docker-compose run --rm udns udnsc    # Client

Using Docker:

$ docker run -d -p 53:53/udp prologic/udns

From PyPi (coming soon):

$ pip install udns
$ udnsd     # Server
$ udnsc     # Client

Running as a Daemon:

$ sudo udnsd -d --logfile=$(pwd)/udnsd.log --pidfile=$(pwd)/

Managing Zones and Records

udns is a full authoritative, caching DNS server and ships with a client to help manage zones and records. Here are some quick examples:

Create new Zone:

$ udnsc create

Create new Zone from a file:

$ udnsc create


$ udnsc create - <

List Zones:

$ udnsc list

Show Zone Records:

$ udnsc show

Export a Zone::

$ udnsc export


This exports the Zone to stdout which you can pipe into an output file for storage using your shell. e.g: udnsc export >

Add Zone Records:

$ udnsc add www

Delete a Zone Record:

$ udnsc delete www

Delete a Zone:

$ udnsc delete


You __must__ specify zones as fully qualified domain names with a trailing period. e.g:


udns 0.0.2 (2016-01-26)

  • Added support for CNAME(s)
  • Added support for @ ($ORIGIN)
  • Various small bugfixes

udns 0.0.1 (2014-08-26)

  • Initial Release

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
udns-0.0.2-py2-none-any.whl (14.8 kB) Copy SHA256 hash SHA256 Wheel 2.7 Jan 27, 2016
udns-0.0.2.tar.gz (11.2 kB) Copy SHA256 hash SHA256 Source None Jan 27, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page