Newer Older

Tomek Mrugalski's avatar
Tomek Mrugalski committed
1. Generate the configure script.  If you downloaded the source from git or
Thomas Markwalder's avatar
Thomas Markwalder committed
are compiling with premium hook packages, you will need to run autoreconf to
Tomek Mrugalski's avatar
Tomek Mrugalski committed
5 6
generate the configure script as shown below.  If you are building from a
tarball you may skip this step.
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

   $ autoreconf --install

2. Run the configure script.  If you want to alter Kea's installation path, or
need to include capabilities (e.g. enabling MySQL or PostgreSQL) you will need
to specify these as options to the configure script (run ./configure -h for
list of options).

   $ ./configure

If your environment is missing dependencies, the configure script will exit
with error and should emit sufficient information to guide you on how to
proceed.  A detailed account of the configure process is captured in

3. Build it. Once you've successfully configured the source tree, run "make" to
build it.  You may wish to include the -j<n> command line option to specify
parallel execution to speed things along:

  $ make

Tomek Mrugalski's avatar
Tomek Mrugalski committed
28 29
4. Install it. Depending on your target directory, this step will likely require
a root privileges. You can install the software by running:

Tomek Mrugalski's avatar
Tomek Mrugalski committed
  $ sudo make install

33 34 35 36
Kea depends on C++ compiler, make, libtool, boost (at least includes, but many
OSes require boost-system library), log4cplus and one crypto library (either
OpenSSL or Botan) for compilation.  Optional backends (MySQL, PostgreSQL and
Cassandra) have additional dependencies. For detailed installation directions,
37 38
see the documentation in doc/sphinx/arm/install.rst text file 
or on the Kea online docs:
39 40
Other optional dependencies are FreeRADIUS client (this requires a subscriber
only RADIUS hook) and Sysrepo, a system for providing YANG/NETCONF interface.

Vicky Risk's avatar
Vicky Risk committed
42 43
You can find current OS-specific build/installation
instructions in our knowledge base at