= NomenPy =

A database backed DNS server written in Python and a dirty hack of an admin interface.

== Getting Started ==

You have already found the source code, since you're reading this document. Just in case the README got separated from the rest of the source, you can find the entire distribution here:


0. Create and activate a virtual environment. (details: http://pypi.python.org/pypi/virtualenv)

  1. Install NomenPy

$ python setup.py install

  1. Create a configuration file

$ nomenpyd -n my_configuration.py

  1. Edit your configuration file

Open my_configuration.py, change the RUN_AS_USER value to the operating system user that will run the NomenPy process. The server defaults to SQLite database. If you don't want to use a SQLite database, now is the time to update the DATABASES setting.

  1. Initialize the database

$ nomenpyd -c my_configuration.py -i

You will be asked to create an administrative user if this is a new installation.

  1. Run the server

# nomenpyd -c my_configuration.py

Start the server as root so it can bind to port 53. It will drop privileges immediately after it starts listening on port 53.

== Adding Records ==

A dirty hack of an admin interface was mentioned earlier in this document. The dirty hack? There is no admin interface, but the Django admin interface is available. Want to use it?

$ django-admin.py --settings=my_configuration $ firefox http://localhost:8000/admin