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 `apt <https://packages.debian.org/pdns-server>`__ system.
  18 Your distribution likely ships a package, but we recommend getting more recent packages from `the PowerDNS repositories <https://repo.powerdns.com>`__.
  19 Please see the instructions on the repo site and then come back here!
  20
  21 .. code-block:: shell
  22
  23     $ sudo apt-get install pdns-server
  24
  25 Debian splits the backends into `several different
  26 packages <https://packages.debian.org/pdns-backend>`__, install the
  27 required backend as follows:
  28
  29 .. code-block:: shell
  30
  31     $ sudo apt-get install pdns-backend-$backend
  32
  33 Redhat-based Systems
  34 ~~~~~~~~~~~~~~~~~~~~
  35
  36 On RedHat based systems there are 2 options to install PowerDNS, from
  37 `EPEL <https://fedoraproject.org/wiki/EPEL>`__,
  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, try :doc:`guides/basic-database` using SQLite 3 or start :doc:`migrating <migration>` your data.