Metadata-Version: 2.1
Name: DoTH-DNS
Version: 7.0.0
Summary: DoTH-DNS gives you great control over your DNS traffic
Home-page: https://github.com/Cielquan/DoTH-DNS
Author: Christian Riedel
Maintainer: Christian Riedel
Maintainer-email: cielquan@protonmail.com
License: GPL-3.0
Project-URL: Source, https://github.com/Cielquan/DoTH-DNS
Project-URL: Documentation, https://doth-dns.readthedocs.io/
Project-URL: Tracker, https://github.com/Cielquan/DoTH-DNS/issues
Keywords: DNS,docker,pi-hole,unbound,doh,dot,traefik
Platform: Linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: Security
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: ~=3.6
Description-Content-Type: text/x-rst
Requires-Dist: click (<8,>=7)
Requires-Dist: docker (<5,>=4.2.0)
Requires-Dist: requests (<3,>=2)
Requires-Dist: tzlocal (<3,>=2)
Provides-Extra: docs
Requires-Dist: sphinx (<3,>=2.0) ; extra == 'docs'
Requires-Dist: sphinx-click (<3,>=2.3) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme (>=0.4) ; extra == 'docs'
Provides-Extra: testing
Requires-Dist: pytest (<6,>=5.0) ; extra == 'testing'
Requires-Dist: pytest-cov (<3,>=2.5) ; extra == 'testing'
Requires-Dist: pytest-mock (<3,>=2.0) ; extra == 'testing'
Requires-Dist: pytest-xdist (<2,>=1.31) ; extra == 'testing'

DoTH-DNS
========

**Your server doth DNS the safe way if you use DoTH-DNS.**

| |license| |black|
|
| |docs|
|
| |release| |commits_since|  |last_commit|
| |stars| |forks| |contributors|
|

Utilizes the power of the DNS sinkhole `pi-hole`_ and `unbound`_
to create a DNS server under your own authority but with the ability to connect via
Do53 (default, unencrypted), DoH (`DNS over HTTPS`__) and DoT (`DNS over TLS`__).

__ https://en.wikipedia.org/wiki/DNS_over_HTTPS
__ https://en.wikipedia.org/wiki/DNS_over_TLS
.. _pi-hole: https://pi-hole.net
.. _unbound: https://www.nlnetlabs.nl/projects/unbound/about


Documentation
-------------
Documentation is available at `doth-dns.readthedocs.io <https://doth-dns.readthedocs.io/>`_.


Disclaimer
----------
Use at own risk see the License.rst file for more details.


Acknowledgements
----------------

Thanks to the creators, maintainers and developers of the software used in this project.

Special thanks to:

- the `dns-over-https`__ project and its `docker version`__ as a base for my Dockerfile.
- the `docker-pihole-unbound`__ project for the inspiration.
- this `blog post`__ and this `blog post`__ being the first foundation of this project.

__ https://github.com/m13253/dns-over-https
__ https://github.com/goofball222/dns-over-https
__ https://github.com/chriscrowe/docker-pihole-unbound
__ https://www.aaflalo.me/2018/10/tutorial-setup-dns-over-https-server
__ https://www.bentasker.co.uk/documentation/linux/407-building-and-running-your-own-dns-over-https-server


.. .############################### LINKS ###############################

.. BADGES START

.. info block
.. |license| image:: https://img.shields.io/github/license/Cielquan/DoTH-DNS.svg?style=for-the-badge
    :alt: License
    :target: https://github.com/Cielquan/DoTH-DNS/blob/master/LICENSE.rst

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge
    :alt: Code Style: Black
    :target: https://github.com/psf/black


.. tests block
.. |docs| image:: https://img.shields.io/readthedocs/doth-dns/latest.svg?style=for-the-badge&logo=read-the-docs&logoColor=white
    :alt: Read the Docs (latest) - Status
    :target: https://doth-dns.readthedocs.io/en/latest/?badge=latest


.. Github block
.. |release| image:: https://img.shields.io/github/v/release/Cielquan/DoTH-DNS.svg?style=for-the-badge&logo=github
    :alt: Github Latest Release
    :target: https://github.com/Cielquan/DoTH-DNS/releases/latest

.. |commits_since| image:: https://img.shields.io/github/commits-since/Cielquan/DoTH-DNS/latest.svg?style=for-the-badge&logo=github
    :alt: GitHub commits since latest release
    :target: https://github.com/Cielquan/DoTH-DNS/commits/master

.. |last_commit| image:: https://img.shields.io/github/last-commit/Cielquan/DoTH-DNS.svg?style=for-the-badge&logo=github
    :alt: GitHub last commit
    :target: https://github.com/Cielquan/DoTH-DNS/commits/master

.. |stars| image:: https://img.shields.io/github/stars/Cielquan/DoTH-DNS.svg?style=for-the-badge&logo=github
    :alt: Github stars
    :target: https://github.com/Cielquan/DoTH-DNS/stargazers

.. |forks| image:: https://img.shields.io/github/forks/Cielquan/DoTH-DNS.svg?style=for-the-badge&logo=github
    :alt: Github forks
    :target: https://github.com/Cielquan/DoTH-DNS/network/members

.. |contributors| image:: https://img.shields.io/github/contributors/Cielquan/DoTH-DNS.svg?style=for-the-badge&logo=github
    :alt: Github Contributors
    :target: https://github.com/Cielquan/DoTH-DNS/graphs/contributors

..  BADGES END


