Skip to main content

udns - a micro (µ) DNS Server

'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 https://github.com/prologic/udns
$ cd udns
$ python setup.py develop
$ sudo udnsd --debug  # Server
$ udnsc --help        # Client

From Source using Docker and Docker Compose:

$ git clone https://github.com/prologic/udns
$ 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)/udnsd.pid

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 abc.com.

Create new Zone from a file:

$ udnsc create abc.com. abc.com

or::

$ udnsc create abc.com. - < abc.com

List Zones:

$ udnsc list

Show Zone Records:

$ udnsc show abc.com.

Export a Zone::

$ udnsc export abc.com.

Add Zone Records:

$ udnsc add abc.com. www 127.0.0.1

Delete a Zone Record:

$ udnsc delete abc.com. www

Delete a Zone:

$ udnsc delete abc.com.

Changes

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

Metadata

Release files for udns 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for udns 0.0.2
File Size Uploaded
udns-0.0.2.tar.gz 11.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for udns 0.0.2
File Interpreter ABI Platform
udns-0.0.2-py2-none-any.whl Python 2 none any Details

Total release size: 26.0 kB

Release files / udns-0.0.2.tar.gz

Download URL udns-0.0.2.tar.gz
Size 11.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a9cda6058041f4c820e5504e7c6f6b6f6ffad2d2c42c40eabd9290e60bf0a2fb
BLAKE2b-256 checksum
How to use checksums
eb884e4c4a44ff4b9b6bab9b4f6d345acbe86f6da6fb29335a988e61eaa20b8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / udns-0.0.2-py2-none-any.whl

Download URL udns-0.0.2-py2-none-any.whl
Size 14.8 kB
Tags Python 2
SHA-256 checksum
How to use checksums
055875fcb65fa84f0310beaf1d004eae0d0655718ca0f14aeb987a04e316456d
BLAKE2b-256 checksum
How to use checksums
b8ded6c1c967e70366947daca689a680566b289fae0e44c0ed9246ee0ce6e622
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page