Careful! You are browsing documentation for an outdated version of Kong. Go here
to browse the documentation for the latest version.
Estimated reading time:
2 minutes
Table of Contents
- Installation Steps
- Install HTTPie to Make Commands more Easily
- Verify Kong Installation
- Install Kong Manager
Installation Steps
$ sudo yum update
$ wget 'https://<BINTRAY_USER:<PASSWORD>@bintray.com/kong/kong-enterprise-edition-aws/rpm' -O bintray-kong-kong-enterprise-edition-aws.repo --auth-no-challenge
$ sudo mv bintray-kong-kong-enterprise-edition-aws.repo /etc/yum.repos.d/
$ sudo vi /etc/yum.repos.d/bintray-kong-kong-enterprise-edition-aws.repo
Ensure baseurl is correct
baseurl=https://<BINTRAY_USER>:<BINTRAY_API_KEY>@kong.bintray.com/kong-enterprise-edition-aws
$ sudo yum install kong-enterprise-edition
$ sudo yum install postgresql postgresql-server
$ sudo service postgresql-setup initdb
$ sudo service postgresql start
$ sudo -i -u postgres (puts you into new shell)
Note: <USERNAME> is obtained from your access key, by appending a %40kong
to it (encoded form of @kong). For example, if your access key is bob-company,
your username will be bob-company%40kong.
Create kong user
$ psql
> CREATE USER kong; CREATE DATABASE kong OWNER kong; ALTER USER kong WITH password 'kong';
> \q
> quit
# Change entries from ident to md5
$ sudo vi /var/lib/pgsql/data/pg_hba.conf
$ sudo service postgresql restart
# add contents of license file
$ sudo vi /etc/kong/license.json
# Uncomment and add 'kong' to pg_password line
$ sudo vi [/path/to/kong.conf]
# Run migrations and start kong
$ kong migrations up [-c /path/to/kong.conf]
$ sudo /usr/local/bin/kong start [-c /path/to/kong.conf]
Note: You may use kong.conf.default or create your own configuration.
Install HTTPie to Make Commands more Easily
$ sudo yum install python-pip
$ sudo pip install --upgrade pip setuptools
$ sudo pip install --upgrade httpie
Verify Kong Installation
$ http :8001/apis name=demo uris=/ upstream_url=http://httpbin.org
$ http :8000/ip
Install Kong Manager
# 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 [/path/to/kong.conf]
# Restart kong
$ sudo /usr/local/bin/kong stop
$ sudo /usr/local/bin/kong start [-c /path/to/kong.conf]
In a browser, load your server on port 8002