Kong is a scalable and customizable API Management Layer built on top of nginx.

• Installation
• Documentation
• Usage
• Development

See INSTALL.md for installation instructions on your platform.

A complete documentation can be found at: getkong.org/docs

Use Kong through the bin/kong executable. Make sure your Cassandra instance is running.

The first time ever you're running Kong, you need to make sure to setup Cassandra by executing:

bin/kong migrate

To start Kong:

bin/kong start

See all the available options, with bin/kong -h.

Running Kong for development requires you to run:

make dev

This will create your environment configuration files (dev and tests). Setup your database access for each of these enviroments (be careful about keyspaces, since Kong already uses kong and unit tests already use kong_tests).

• Run the tests:

make test-all

• Run it:

bin/kong -c config.dev/kong.yml -n config.dev/nginx.conf start

When developing, use the Makefile for doing the following operations:

Those scripts provide handy features while developing Kong:

# Complete usage
scripts/db.lua --help

# Migrate up
scripts/db.lua migrate [configuration_path] # for all commands, the default configuration_path is config.dev/kong.yml

# Migrate down (currently equivalent to reset)
scripts/db.lua rollback

# Reset DB (danger!)
scripts/db.lua reset

# Seed DB
scripts/db.lua seed

# Drop DB (danger!)
scripts/db.lua drop