Need help with designate?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

147 Stars 74 Forks Apache License 2.0 4.3K Commits 0 Opened issues


OpenStack DNS As A Service (Designate). Mirror of code maintained at

Services available


Need anything else?

Contributors list


Team and repository tags

.. image:: :target:

.. Change things from this point on


OpenStack Designate

Designate is an OpenStack project, providing DNSaaS.

IRC: #openstack-dns @ oftc



To learn how to use Designate's API, consult the documentation available online at:

  • DNS API Reference 

For more information on OpenStack APIs, SDKs and CLIs in general, refer to:

  • OpenStack for App Developers 
  • Development resources for OpenStack clouds


Designate follows the

OpenStack Gerrit Workflow


Setup a working environment:

.. code-block:: bash

git clone
cd designate
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
pip install -e .

Building Docs

To build the documentation from the restructured text source, do the following:

.. code-block:: bash

tox -e docs

Now point your browser at doc/build/html/index.html (the official documentation is published to
_ by the maintainers.


Execute all unit tests

.. code-block:: shell

tox -e py36

Execute only backend tests

.. code-block:: shell

tox -e py36 -- unit.backend

Execute only a single test

.. code-block:: shell

tox -e py36 -- unit.backend.test_pdns4.PDNS4BackendTestCase.test_create_zone_success


Install the git-review package to make life easier

.. code-block:: shell

pip install git-review

Branch, work, & submit:

.. code-block:: shell

# cut a new branch, tracking master
git checkout --track -b bug/id origin/master
# work work work
git add stuff
git commit
# rebase/squash to a single commit before submitting
git rebase -i
# submit

Other Information

  • Free software: Apache license
  • Documentation:
  • Release notes:
  • Source:
  • Bugs:
  • Blueprints:

.. _OpenStack Gerrit Workflow: ..

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.