Careful! You are browsing documentation for an outdated version of Kong. Go here
to browse the documentation for the latest version.
Estimated reading time:
1 minute
Table of Contents
Install Kong Enterprise
curl the EE binary for Ubuntu (or Debian) from Bintray to your Ubuntu server
Then, with the file local:
$ sudo apt-get update
$ sudo apt-get install openssl libpcre3 procps perl
$ sudo dpkg -i kong-enterprise-edition-0.32.zesty.all.deb
NOTE: EE file may differ in last step above. In addition to Zesty, we currently build for Precise, Trusty, and Xenial.
Install PostgreSQL
$ sudo apt-get install postgresql
$ sudo -i -u postgres (puts you into new shell)
Create kong user
$ psql
> CREATE USER kong; CREATE DATABASE kong OWNER kong; ALTER USER kong WITH password 'kong';
> \q
$ exit
Finish Kong Enterprise setup steps
# Add contents of your license file (copy & paste)
$ sudo vi /etc/kong/license.json
$ sudo cp /etc/kong/kong.conf.default /etc/kong/kong.conf
# Uncomment and add 'kong' to pg_password line
$ sudo vi /etc/kong/kong.conf
Run migrations and start kong
$ sudo /usr/local/bin/kong migrations up
$ sudo /usr/local/bin/kong start
Test your Kong installation
$ curl -i -X POST \
--url http://localhost:8001/apis/ \
--data 'name=demo' \
--data 'uris=/' \
--data 'upstream_url=http://httpbin.org'
$ curl -i -X GET \
--url http://localhost:8000/ip
Setup Admin GUI
# Get the local IP address
$ ifconfig
# Uncomment the admin_listen setting, and update to
# something like this `admin_listen = 172.31.3.8:8001`
$ sudo vi /etc/kong/kong.conf
# Restart kong
$ sudo /usr/local/bin/kong stop
$ sudo /usr/local/bin/kong start
In a browser, load your server on port 8002