Ubuntu Installation

Packages

Start by downloading the corresponding package for your configuration:

• 12.04 Precise
• 14.04 Trusty
• 16.04 Xenial
• 17.04 Zesty
• 18.04 Bionic

Enterprise trial users should download their package from their welcome email and save their license to /etc/kong/license.json after step 1.

APT Repositories

You can also install Kong via APT; follow the instructions on the “Set Me Up” section on the page below, setting distribution to the appropriate value ( lsb_release -sc ) (e.g., precise) and components to main.

• Deb Repository

---

Installation

1. Install Kong

   If you are downloading the package, execute:

    $ sudo apt-get update
    $ sudo apt-get install openssl libpcre3 procps perl
    $ sudo dpkg -i kong-1.1.2.*.deb
   

   If you are using the apt repository execute:

    $ sudo apt-get update
    $ sudo apt-get install -y apt-transport-https curl lsb-core
    $ echo "deb https://kong.bintray.com/kong-deb `lsb_release -sc` main" | sudo tee -a /etc/apt/sources.list
    $ curl -o bintray.key https://bintray.com/user/downloadSubjectPublicKey?username=bintray
    $ sudo apt-key add bintray.key
    $ sudo apt-get update
    $ sudo apt-get install -y kong
   

2. Prepare your database

   Configure Kong so it can connect to your database. Kong supports both PostgreSQL 9.5+ and Cassandra 3.x.x as its datastore.

   If you are using Postgres, please provision a database and a user before starting Kong, ie:

    CREATE USER kong; CREATE DATABASE kong OWNER kong;
   

   Now, run the Kong migrations:

    $ kong migrations bootstrap [-c /path/to/kong.conf]
   

   Note for Kong < 0.15: with Kong versions below 0.15 (up to 0.14), use the up sub-command instead of bootstrap. Also note that with Kong < 0.15, migrations should never be run concurrently; only one Kong node should be performing migrations at a time. This limitation is lifted for Kong 0.15, 1.0, and above.

3. Start Kong

    $ kong start [-c /path/to/kong.conf]
   

4. Use Kong

   Kong is running:

    $ curl -i http://localhost:8001/
   

   Quickly learn how to use Kong with the 5-minute Quickstart.

---