Install Kong Gateway

Set up Kong Gateway with Konnect, or install it on self-managed infrastructure.

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

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AMD64

3.15.0.3

ARM64

3.15.0.3

Package manager

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

Copied!

Note: Kong Gateway is packaged for 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.15.0.3

ARM64

3.15.0.3

AMD64 - FIPS

3.15.0.3

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-315/config.rpm.txt?distro=el&codename=$(rpm --eval '%{rhel}')" | sudo tee /etc/yum.repos.d/kong-gateway-315.repo
sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-315'
sudo yum install -y kong-enterprise-edition-3.15.0.3

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AARCH64

3.15.0.3

X86_64

3.15.0.3

X86_64 - FIPS

3.15.0.3

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-315/config.rpm.txt?distro=amzn&codename=$(rpm --eval '%{amzn}')" | sudo tee /etc/yum.repos.d/kong-gateway-315.repo > /dev/null
sudo yum -q makecache -y --disablerepo='*' --enablerepo='kong-gateway-315'
sudo yum install -y kong-enterprise-edition-3.15.0.3

Copied!

After installation, configure the datastore to complete setup.

Binary Download

AARCH64

3.15.0.3

X86_64

3.15.0.3

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 →

Distroless image

The distroless image contains only the Kong Gateway runtime and its dependencies, with no shell, package manager, or OS tooling. It's available for AMD64 and ARM64 architectures.

Install via distroless image →

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 using the kong migrations CLI. See the OSS to Enterprise migration guide for step-by-step instructions.

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.

How do I install a downloaded package file?

If you have already downloaded a Kong Gateway package file, you can install it using your package manager.

For .deb files:

sudo apt install --yes /path/to/kong-enterprise-edition__amd64.deb

Copied!

For .rpm files:

sudo yum install -y kong-enterprise-edition-

Copied!

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

Distroless image

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?