docs/installation.rst

   1 Installing PowerDNS
   2 ===================
   3
   4 Installation of the PowerDNS Authoritative server on UNIX systems can be
   5 done in several ways:
   6
   7 -  Binary packages provided by your distribution
   8 -  Binary packages provided by PowerDNS on
   9    `repo.powerdns.com <https://repo.powerdns.com>`__
  10
  11 Binary Packages
  12 ---------------
  13
  14 Debian-based Systems
  15 ~~~~~~~~~~~~~~~~~~~~
  16
  17 PowerDNS Authoritative Server is available through the
  18 `apt <https://packages.debian.org/pdns-server>`__ system.
  19
  20 .. code-block:: shell
  21
  22     $ sudo apt-get install pdns-server
  23
  24 Debian splits the backends into `several different
  25 packages <https://packages.debian.org/pdns-backend>`__, install the
  26 required backend as follows:
  27
  28 .. code-block:: shell
  29
  30     $ sudo apt-get install pdns-backend-$backend
  31
  32 Redhat-based Systems
  33 ~~~~~~~~~~~~~~~~~~~~
  34
  35 On RedHat based systems there are 3 options to install PowerDNS, from
  36 `EPEL <https://fedoraproject.org/wiki/EPEL>`__, the `repository from
  37 Kees Monshouwer <https://www.monshouwer.eu/download/3rd_party/pdns/>`__
  38 or from `the PowerDNS repositories <https://repo.powerdns.com>`__:
  39
  40 Add either to your list of repositories and install PowerDNS by issuing:
  41
  42 .. code-block:: shell
  43
  44     $ sudo yum install pdns
  45
  46 The different backends can be installed using
  47
  48 .. code-block:: shell
  49
  50     $ sudo yum install pdns-backend-$backend
  51
  52 Note that for some of those package sources, the bind backend is shipped as part of the base ``pdns`` package, and there is no separate ``pdns-backend-bind`` package.
  53
  54 FreeBSD
  55 ~~~~~~~
  56
  57 PowerDNS Authoritative Server is available through the
  58 `ports <http://www.freshports.org/dns/powerdns/>`__ system:
  59
  60 For the package:
  61
  62 .. code-block:: shell
  63
  64     $ sudo pkg install dns/powerdns
  65
  66 To have your system build the port:
  67
  68 .. code-block:: shell
  69
  70     cd /usr/ports/dns/powerdns/ && make install clean
  71
  72 Mac OS X
  73 ~~~~~~~~
  74
  75 PowerDNS Authoritative Server is available through Homebrew:
  76
  77 .. code-block:: shell
  78
  79     $ brew install pdns
  80
  81 After installation
  82 ------------------
  83
  84 Once installed, :doc:`guides/basic-database` using MySQL or start :doc:`migrating <migration>` your data.