Install Kong Gateway

Kong Gateway is a low-demand, high-performing API gateway. You can set up Kong Gateway with Konnect, or install it on various self-managed systems.

Uses: Kong Gateway

Konnect is Kong's SaaS platform for running Kong Gateway without any infrastructure to manage. Get a fully managed Control Plane, real-time analytics, and enterprise-grade security.

Sign up for free →

Linux

Package manager

curl -1sLf "https://packages.konghq.com/public/gateway-312/gpg.875433A518B93006.key" |  gpg --dearmor | sudo tee /usr/share/keyrings/kong-gateway-312-archive-keyring.gpg > /dev/null
curl -1sLf "https://packages.konghq.com/public/gateway-312/config.deb.txt?distro=debian&codename=$(lsb_release -sc)" | sudo tee /etc/apt/sources.list.d/kong-gateway-312.list > /dev/null
sudo apt-get update && sudo apt install -y kong-enterprise-edition=3.12.0.0

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AMD64

3.12.0.0

ARM64

3.12.0.0

Package manager

curl -1sLf "https://packages.konghq.com/public/gateway-312/gpg.875433A518B93006.key" |  gpg --dearmor | sudo tee /usr/share/keyrings/kong-gateway-312-archive-keyring.gpg > /dev/null
curl -1sLf "https://packages.konghq.com/public/gateway-312/config.deb.txt?distro=ubuntu&codename=noble" | sudo tee /etc/apt/sources.list.d/kong-gateway-312.list > /dev/null
sudo apt-get update && sudo apt-get install -y kong-enterprise-edition=3.12.0.0

Copied!

Note: Kong Gateway is packaged for Focal, Jammy, Noble. The snippet above assumes you are running Noble. Replace it with your release. To check the name of your release, run lsb_release -sc.

After installation, configure the datastore to complete setup.

Binary Download

AMD64

3.12.0.0

ARM64

3.12.0.0

AMD64 - FIPS

3.12.0.0

For FIPS-compliant environments, you must also enable fips = on in your Kong configuration file.

Package manager

curl -1sLf "https://packages.konghq.com/public/gateway-312/config.rpm.txt?distro=el&codename=$(rpm --eval '%{rhel}')" | sudo tee /etc/yum.repos.d/kong-gateway-312.repo
sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-312'
sudo yum install -y kong-enterprise-edition-3.12.0.0

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AARCH64

3.12.0.0

X86_64

3.12.0.0

X86_64 - FIPS

3.12.0.0

For FIPS-compliant environments, you must also enable fips = on in your Kong configuration file.

Package manager

curl -1sLf "https://packages.konghq.com/public/gateway-312/config.rpm.txt?distro=amzn&codename=$(rpm --eval '%{amzn}')" | sudo tee /etc/yum.repos.d/kong-gateway-312.repo > /dev/null
sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-312'
sudo yum install -y kong-enterprise-edition-3.12.0.0

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AARCH64

3.12.0.0

X86_64

3.12.0.0

Docker

Using Docker Compose

Kong Gateway is available as a Docker image, making it easy to deploy in containerized environments.

Install via Docker → Install via Docker in read-only mode →

Build your own

Kong Gateway is distributed as prebuilt deb and rpm packages, in addition to official Docker images hosted on Docker Hub.

Build your own Docker image →

Kubernetes

Deploy Kong Gateway on Kubernetes

Deploy Kong Gateway on Kubernetes, and configure it using the UI, decK or Terraform.

Install via Helm → Install via Kong Operator →

Install Kong Ingress Controller (KIC)

Configure Kong Gateway using Kubernetes-native resources such as httproute and ingress.

Install via Helm → Install via Kong Operator →

FAQs

How do I migrate from Kong Gateway open source (OSS) to Kong Gateway Enterprise?

You can migrate to Kong Gateway Enterprise using the kong migrations CLI commands.

Warning: This action is irreversible, therefore we strongly recommend backing up your production data before migrating from Kong Gateway OSS to Kong Gateway Enterprise.

You can only migrate to a Kong Gateway Enterprise version that supports the same OSS version. The latest version of Kong Gateway OSS is 3.9.1.

Download the Kong Gateway Enterprise package that matches your installed OSS version.
Configure it to point to the same data store as your Kong Gateway OSS node. The migration command expects the data store to be up to date on any pending migration:
```
kong migrations up [-c configuration_file]
kong migrations -f finish [-c configuration_file]
```
Copied!
Caution: When adding new plugins to the existing installation (either manually or via the extension of bundled plugins), the kong migrations finish or kong migrations up must be run with the -f flag to forcefully upgrade the plugin schemas.
Confirm that all of the entities are now available on your Kong Gateway Enterprise node.
(Optional) Upgrade to your desired version of Kong Gateway Enterprise.

How do I install Kong Gateway on Windows?

To install Kong Gateway on Windows, use Docker. Kong does not provide a native Windows install method for Kong Gateway.

Where can I find all supported platforms and packaging options?

To find all supported platforms and package types for Kong Gateway, see the supported platforms and versions in the Kong Gateway version support policy.

If you don’t see your Kong Gateway version here, it has reached end of life and Kong no longer publishes any packages or images for it.

Next Steps

Get started with Kong Gateway

Install Kong Gateway

Linux

Package manager

Binary Download

Package manager

Binary Download

Package manager

Binary Download

Package manager

Binary Download

Docker

Using Docker Compose

Build your own

Kubernetes

Deploy Kong Gateway on Kubernetes

Install Kong Ingress Controller (KIC)

FAQs

Next Steps

Help us make these docs great!

Still need help