You are browsing documentation for an outdated version. See the
latest documentation here.
Install Kong Gateway on Debian
Download the latest Kong 2.6.x package for Debian:
(latest version: 2.6.1)
View the list of all 2.x packages for
10 Buster, or
Kong is licensed under an
Apache 2.0 license.
You have a supported system with root or root-equivalent access.
Download and install
You can install Kong Gateway by downloading an installation package or using our APT repository.
Prepare your configs
Kong can run either with or without a database.
When using a database, you will use the
kong.conf configuration file for setting Kong’s
configuration properties at start-up and the database as storage of all configured entities,
such as the Routes and Services to which Kong proxies.
When not using a database, you will use
kong.conf its configuration properties and a
file for specifying the entities as a declarative configuration.
Using a database
Deprecation warning: Cassandra as a backend database for Kong Gateway
is deprecated. This means the feature will eventually be removed.
Our target for Cassandra removal is the Kong Gateway 4.0 release.
Starting with the Kong Gateway 3.0 release, some new features might
not be supported with Cassandra.
Configure Kong so it can connect to your database. Kong supports both PostgreSQL and Cassandra as its datastore.
If you are using Postgres, provision a database and a user before starting Kong:
CREATE USER kong; CREATE DATABASE kong OWNER kong;
Run the Kong migrations:
$ kong migrations bootstrap [-c /path/to/kong.conf]
Without a database
If you are going to run Kong in DB-less mode,
you should start by generating declarative config file.
kong.yml file in your current folder using the following command:
The file contains instructions about how to populate it.
kong.conf file. Set the
off and the
declarative_config option to the path of your
database = off
declarative_config = /path/to/kong.yml
Run Kong Gateway
Note: When you start Kong, the NGINX master process runs
root and the worker processes as
kong by default.
If this is not the desired behavior, you can switch the NGINX master process to run on the built-in
kong user or to a custom non-root user before starting Kong. For more
information, see Running Kong as a Non-Root User.
- Start Kong Gateway:
kong start [-c /path/to/kong.conf]
Check that Kong Gateway is running:
curl -i http://localhost:8001/
Check out Kong Gateway’s series of
Getting Started guides to get the most
out of Kong Gateway.