# Quick start

This quickly covers the standard steps for installing and deploying Kea. For further details, full customizations, and troubleshooting, see the respective chapters in the Kea guide.

## Quick start guide for DHCPv4 and DHCPv6 services

1. Install required run-time and build dependencies. See for details.

2. Checkout the latest Kea revision from the Git repository:

       $ git clone git://git.kea.isc.org/kea

3. Go into the source directory and run the configure script:

       $ cd kea
       $ autoreconf --install
       $ ./configure [your extra parameters]

4. Build it:

       $ make

5. Install it (by default the installation prefix is `/usr/local/`, so you need root privileges for that step):

       $ make install

6. If you wish to run a DHCP server for IPv4, you need to set up and start the kea-dhcp4 server:

   1. Edit your configuration file for DHCPv4. describes the configuration choices available; example DHCPv4 configuration can be found in doc/examples/kea4.

   2. Start Kea DHCPv4 server (as root):

          # kea-dhcp4 -c /path/to/your/kea4/config/file.json

   3. Test it; for example, use the ISC DHCP client to send DHCPv4 queries to the server and verify that the client receives a configuration from the server:

          $ dhclient -4 eth0

7. If you wish to run a DHCP server for IPv6, you need to set up and start the kea-dhcp6 server:

   1. Edit your configuration file for DHCPv6. describes the configuration ch, and some example DHCPv6 configuration can be found in doc/examples/kea6.

   2. Start Kea DHCPv6 server (as root):

          # kea-dhcp6 -c /path/to/your/kea6/config/file.json

   3. Test it; for example, use the ISC DHCP client to send DHCPv6 queries to the server and verify that the client receives a configuration from the server:

          $ dhclient -6 eth0