Skip to main content

Pure Python DNS server for developers

Project description

PyDevNS is a pure Python DNS server for developers. You know how you need a domain name to use for interacting with your app locally? Well, this is the tool for you.


pip install devns

Hey, not everything has to be hard.


I know what you’re thinking:

Dude, what? I just put in my /etc/hosts file.

That’s all well and good, but what about when you need and *

There’s like a million things out there that do this. I could use dnsmasq, or one of the other 40 random Python “dev DNS” servers you probably stole your implementation from.

OK, dnsmasq kind of seems like overkill, but what about when you need or to work from inside a docker container?

Well then I just make dnsmasq resolve it to my real IP instead of

So you edit the config and restart dnsmasq every time you move from home, to the coffee shop, to the office, wherever…

That is kind of a pain, now that you mention it…

Thought so.

Default Behavior

If you run devns with no arguments, the server will start, bind to with a random port and try to discover a suitable IP address to use for resolving any incoming DNS requests. It literally does not care what domain you ask for, it always responds and always with the same IP, hopefully the IP address of your actual network interface (e.g. or whatever). It tries to figure that out on its own, and I think it does a pretty good job of it.

But then how do I make DNS queries go to it, especially if it’s using a random port every time it runs?

Glad you asked. It’ll also try to write a file to /etc/resolver/dev, which if your OS supports such things, would tell it to send any DNS queries for domains ending it .dev to devns.

But wouldn’t I need to…

Run it with sudo to do that? Yeah probably, unless your system is insane and just lets anybody write to /etc all willy nilly, in which case you have bigger problems than getting to resolve to something sensible.

Don’t I have to restart it every time my IP changes, just like dnsmasq?

No, there’s a configurable TTL associated with the address devns uses in its responses. By default, that’s 5 minutes. If a query comes in and the address was last confirmed more than 5 minutes prior, it’ll try to rediscover it. That should cover most cases of relocating from one spot to another.


Run the server with a random port and auto-configured resolver for .dev resolving to a sensible, auto-detected IP address:

sudo devns

Rediscover the response address every 15 minutes instead of 5:

sudo devns --ttl 900

Listen on port 53535 without writing any resolver files:

devns --port 53535 --no-resolver

Write the resolver files to /usr/local/etc/resolver instead of /etc/resolver:

devns --resolver-dir /usr/local/etc/resolver

Respond to all queries with, and ignore the TTL:

sudo devns --address

Listen on port 53535, write config files for .dev and

sudo devns --port 53535 --domains dev

Bind to a random port on, and make a lot of noise:

sudo devns --host -vvv


If you have entries in your /etc/hosts for any domains you want to use with devns, you’ll have to remove those. That’s all.


Here’s what devns --help gets you:

usage: devns [-h] [--version] [--verbose | --quiet]
             [--address ADDRESS | --ttl SECONDS] [--host HOST] [--port PORT]
             [--domains [DOMAIN [DOMAIN ...]]] [--resolver-dir DIRECTORY]

PyDevNS - A DNS server for developers.

optional arguments:
  -h, --help            show this help message and exit
  --version             show version and exit

  --verbose, -v         verbose output
  --quiet, -q           quiet mode

  --address ADDRESS, -a ADDRESS
                        IP address to respond with
                        how often to refresh the address

  --host HOST, -H HOST  address to listen on
  --port PORT, -p PORT  port to listen on

  --domains [DOMAIN [DOMAIN ...]], -d [DOMAIN [DOMAIN ...]]
                        domains to create resolver files for
  --resolver-dir DIRECTORY, -rd DIRECTORY
                        where to put resolver files
  --no-resolver, -nr    disable creating resolver files

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
devns-0.5.0-py2.py3-none-any.whl (13.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3
devns-0.5.0.tar.gz (13.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

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