README.md

   1 PowerDNS is copyright Ⓒ 2002-2015 by PowerDNS.COM BV and lots of
   2 contributors, using the GNU GPLv2 license (see NOTICE for the
   3 exact license and exception used).
   4
   5 All documentation can be found on http://doc.powerdns.com/
   6
   7 This file may lag behind at times. For most recent updates, always check
   8 https://doc.powerdns.com/md/changelog/.
   9
  10 Another good place to look for information is:
  11 https://doc.powerdns.com/md/appendix/compiling-powerdns/
  12
  13 To file bugs, head towards:
  14 https://github.com/PowerDNS/pdns/issues
  15
  16 But please check if the issue is already reported there first.
  17
  18 SOURCE CODE / GIT
  19 -----------------
  20
  21 Source code is available on GitHub:
  22
  23     $ git clone https://github.com/PowerDNS/pdns.git
  24
  25 This repository contains the sources both for the PowerDNS Recursor and for PowerDNS Authoritative Server,
  26 and both can be built from this repository. Both are released separately as .tar.bz2, .deb and .rpm however!
  27
  28 COMPILING Authoritative Server
  29 ------------------------------
  30 PowerDNS Authoritative Server 3.0 and beyond depend on Boost.
  31
  32 On Debian 7.0, the following is useful:
  33
  34     apt-get install autoconf automake bison flex g++ git libboost-all-dev libtool make pkg-config ragel libmysqlclient-dev
  35
  36 If you build from git, first build configure:
  37
  38     $ ./bootstrap
  39
  40 (You may need to do that twice. You also need libtool-1.4, 1.3 won't work.
  41 Autoconf 2.61 or newer and Automake 1.11 or newer are required, too.)
  42
  43 To compile a very clean version, use:
  44
  45     $ ./configure --with-modules="" --without-lua
  46     $ make
  47     # make install
  48
  49 This generates a PowerDNS Authoritative Server binary with no modules built in.
  50
  51 When `./configure` is run without `--with-modules`, the bind and gmysql module are
  52 built-in by default and the pipe-backend is compiled for runtime loading.
  53
  54 To add multiple modules, try:
  55
  56     $ ./configure --with-modules="bind gmysql gpgsql"
  57
  58 See http://doc.powerdns.com/compiling-powerdns.html for more details.
  59
  60 COMPILING THE RECURSOR
  61 ----------------------
  62 The portable, and supported, way to build the recursor is:
  63
  64     $ cd pdns/recursordist
  65     $ ./bootstrap
  66     $ ./configure
  67     $ make
  68     # make install
  69
  70 You need `autoconf`, `libtool` and `automake` installed to bootstrap it.
  71 Furthermore, when building from git `boost`, `pandoc`, `ragel` and `zip` are build dependencies.
  72
  73 SOLARIS NOTES
  74 -------------
  75 Use a recent gcc. OpenCSW is a good source, as is Solaris 11 IPS.
  76
  77 If you encounter problems with the Solaris make, gmake is advised.
  78
  79 FREEBSD NOTES
  80 -------------
  81 You need to compile using gmake - regular make only appears to work, but doesn't in fact. Use gmake, not make.
  82
  83 MAC OS X NOTES
  84 --------------
  85 PowerDNS Authoritative Server is available through Homebrew:
  86
  87     $ brew install pdns
  88
  89 If you want to compile yourself, the dependencies can be installed using
  90 Homebrew:
  91
  92     $ brew install boost lua pkg-config ragel
  93
  94 For PostgreSQL support:
  95
  96     $ brew install postgresql
  97
  98 For MySQL support:
  99
 100     $ brew install mariadb
 101
 102 LINUX NOTES
 103 -----------
 104 None really.