Install the dependencies
OpenResty 220.127.116.11. Kong being an OpenResty application, you must follow the OpenResty installation instructions. You will need OpenSSL and PCRE to compile OpenResty, and to at least use the following compilation options:
$ ./configure \ --with-pcre-jit \ --with-ipv6 \ --with-http_realip_module \ --with-http_ssl_module \ --with-http_stub_status_module \ --with-http_v2_module
You might have to specify
--with-openssland you can add any other option you'd like, such as additional Nginx modules or a custom
$ export PATH="$PATH:/usr/local/openresty/bin"
Luarocks 2.4.3, compiled with the LuaJIT version bundled with OpenResty (See the
--with-lua-includeconfigure options). Example:
./configure \ --lua-suffix=jit \ --with-lua=/usr/local/openresty/luajit \ --with-lua-include=/usr/local/openresty/luajit/include/luajit-2.1
Now that OpenResty is installed, we can use Luarocks to install Kong's Lua sources:
$ luarocks install kong 0.14.0-0
$ git clone email@example.com:Kong/kong.git $ [sudo] make install # this simply runs the `luarocks make kong-*.rockspec` command
Finally, place the
bin/kongscript in your
Prepare your database
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 up [-c /path/to/kong.conf]
Note: migrations should never be run concurrently; only one Kong nodes should be performing migrations at a time.
$ kong start [-c /path/to/kong.conf]
Kong is running:
$ curl -i http://localhost:8001/
Quickly learn how to use Kong with the 5-minute Quickstart.
Get future release notes emailed to you.