docs/index.rst

   1 PowerDNS Authoritative Nameserver
   2 =================================
   3
   4 The PowerDNS Authoritative Server is a versatile nameserver which
   5 supports a large number of backends. These backends can either be plain
   6 zone files or be more dynamic in nature.
   7
   8 PowerDNS has the concepts of 'backends'. A backend is a datastore that
   9 the server will consult that contains DNS records (and some meta-data).
  10 The backends range from database backends (:doc:`MySQL <backends/generic-mysql>`, :doc:`PostgreSQL <backends/generic-postgresql>`, :doc:`Oracle <backends/oracle>`)
  11 and :doc:`Bind-zonefiles <backends/bind>` to :doc:`co-processes <backends/pipe>` and :doc:`JSON API's <backends/remote>`.
  12
  13 Multiple backends can be enabled in the configuration by using the
  14 :ref:`setting-launch` option. Each backend can be configured separately.
  15
  16 See the :doc:`backend <backends/index>` documentation for more information.
  17
  18 This documentation is also available as a `PDF document <PowerDNS-Authoritative.pdf>`_.
  19
  20 Getting 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
  27 Getting Support
  28 ---------------
  29 PowerDNS is an open source program so you may get help from the PowerDNS users' community or from its authors.
  30 You may also help others (please do).
  31
  32 Public 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
  38 The PowerDNS company can provide help or support you in private as well.
  39 For 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
  41 My information is confidential, must I send it to the mailing list or discuss on IRC?
  42 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  43 Yes, 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
  45 If 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
  47 I have a question!
  48 ^^^^^^^^^^^^^^^^^^
  49 This happens, we're here to help!
  50 Read below on how you can get help
  51
  52 What details should I supply?
  53 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  54 Start out with stating what you think should be happening.
  55 Quite often, wrong expectations are the actual problem.
  56 Furthermore, your operating system, which version of PowerDNS you use and where you got it from (RPM, .DEB, tar.bz2).
  57 If you compiled it yourself, what were the ``./configure`` parameters.
  58
  59 If possible, supply the actual name of your domain and the IP address of your server(s).
  60
  61 I found a bug!
  62 ^^^^^^^^^^^^^^
  63 As much as we'd like to think we are perfect, bugs happen.
  64 If you have found a bug, please file a bug report on `GitHub <https://github.com/PowerDNS/pdns/issues/new>`_.
  65 Please fill in the template and we'll try our best to help you.
  66
  67 I found a security issue!
  68 ^^^^^^^^^^^^^^^^^^^^^^^^^
  69 Please report this in private, see the :ref:`securitypolicy`.
  70
  71 I have a good idea for a feature!
  72 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  73 We like to work on new things!
  74 You can file a feature request on `GitHub <https://github.com/PowerDNS/pdns/issues/new>`_.
  75