]> git.ipfire.org Git - thirdparty/pdns.git/blame - docs/index.rst
Merge remote-tracking branch 'origin/master' into dnsdist-pkg-fixes
[thirdparty/pdns.git] / docs / index.rst
CommitLineData
0e2063c3
PL
1PowerDNS Authoritative Nameserver
2=================================
3
4The PowerDNS Authoritative Server is a versatile nameserver which
5supports a large number of backends. These backends can either be plain
6zone files or be more dynamic in nature.
7
8PowerDNS has the concepts of 'backends'. A backend is a datastore that
9the server will consult that contains DNS records (and some meta-data).
10The backends range from database backends (:doc:`MySQL <backends/generic-mysql>`, :doc:`PostgreSQL <backends/generic-postgresql>`, :doc:`Oracle <backends/oracle>`)
11and :doc:`Bind-zonefiles <backends/bind>` to :doc:`co-processes <backends/pipe>` and :doc:`JSON API's <backends/remote>`.
12
13Multiple backends can be enabled in the configuration by using the
14:ref:`setting-launch` option. Each backend can be configured separately.
15
16See the :doc:`backend <backends/index>` documentation for more information.
17
a6876aa4
PL
18This documentation is also available as a `PDF document <PowerDNS-Authoritative.pdf>`_.
19
0e2063c3
PL
20Getting Started
21---------------
22
23 * :doc:`Install the Authoritative Server <installation>`
24 * :doc:`Configure the Server <settings>`
25 * :doc:`Configure the backend(s) <backends/index>`
26
27Getting Support
28---------------
29PowerDNS is an open source program so you may get help from the PowerDNS users' community or from its authors.
30You may also help others (please do).
31
32Public support is available via several different channels:
33
34 * This documentation
35 * `The mailing list <https://www.powerdns.com/mailing-lists.html>`_
36 * ``#powerdns`` on `irc.oftc.net <irc://irc.oftc.net/#powerdns>`_
37
38The PowerDNS company can provide help or support you in private as well.
39For first class and rapid support, please contact powerdns.support@powerdns.com, or see the `.com website <https://www.powerdns.com/support-services-consulting.html>`__.
40
41My information is confidential, must I send it to the mailing list or discuss on IRC?
42^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
43Yes, we have a support policy called `"Open Source Support: out in the open" <https://blog.powerdns.com/2016/01/18/open-source-support-out-in-the-open/>`_.
44
45If you desire privacy, please consider entering a support relationship with us, in which case we invite you to contact powerdns.support.sales@powerdns.com.
46
47I have a question!
48^^^^^^^^^^^^^^^^^^
49This happens, we're here to help!
50Read below on how you can get help
51
52What details should I supply?
53^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
54Start out with stating what you think should be happening.
55Quite often, wrong expectations are the actual problem.
56Furthermore, your operating system, which version of PowerDNS you use and where you got it from (RPM, .DEB, tar.bz2).
57If you compiled it yourself, what were the ``./configure`` parameters.
58
59If possible, supply the actual name of your domain and the IP address of your server(s).
60
61I found a bug!
62^^^^^^^^^^^^^^
63As much as we'd like to think we are perfect, bugs happen.
64If you have found a bug, please file a bug report on `GitHub <https://github.com/PowerDNS/pdns/issues/new>`_.
65Please fill in the template and we'll try our best to help you.
66
67I found a security issue!
68^^^^^^^^^^^^^^^^^^^^^^^^^
69Please report this in private, see the :ref:`securitypolicy`.
70
71I have a good idea for a feature!
72^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
73We like to work on new things!
74You can file a feature request on `GitHub <https://github.com/PowerDNS/pdns/issues/new>`_.
75