How to add an additional port for the Kong proxy

Uses: Kong Gateway
TL;DR

How can I add an additional proxy port for Kong to listen to?

Add another entry to proxy_listen in kong.conf (or the KONG_PROXY_LISTEN environment variable) with the desired host and port, then restart Kong. For example, adding 0.0.0.0:9000 reuseport backlog=16384 alongside the existing listeners makes Kong also listen on port 9000.

Overview

How can I add an additional proxy port for Kong to listen to?

Steps

You can add an additional proxy port by adding the port to proxy_listen in kong.conf, or by using the environment variable KONG_PROXY_LISTEN.

For more details, see the configuration reference.

Example:

If you want to add an additional http proxy port that listens on 9000, you would set proxy_listen as below and restart kong afterward.

proxy_listen=0.0.0.0:8000 reuseport backlog=16384, 0.0.0.0:8443 http2 ssl reuseport backlog=16384 , 0.0.0.0:9000 reuseport backlog=16384

Kong now will listen to 8000 and 9000 and you should be able to send an http request to these ports now.

[~] http http://localhost:8000
HTTP/1.1 404 Not Found
Date: Thu, 06 Aug 2026 14:44:59 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Content-Length: 103
X-Kong-Response-Latency: 0
Server: kong/3.14.0.0-enterprise-edition
X-Kong-Request-Id: bba38b6151d61f0bb93ff01f60825d2c

{
  "message":"no Route matched with those values",
  "request_id":"bba38b6151d61f0bb93ff01f60825d2c"
}

[~] http http://localhost:9000
HTTP/1.1 404 Not Found
Date: Thu, 06 Aug 2026 14:44:59 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Content-Length: 103
X-Kong-Response-Latency: 1
Server: kong/3.14.0.0-enterprise-edition
X-Kong-Request-Id: 7cd5d07f69a88a4db8fa6e087854241b

{
  "message":"no Route matched with those values",
  "request_id":"7cd5d07f69a88a4db8fa6e087854241b"
}

Additional Note:

For https, you could just copy the existing configuration in proxy_listen and change the port.

Example:

Config below will add 9443 as an https port:

proxy_listen=0.0.0.0:8000 reuseport backlog=16384, 0.0.0.0:8443 http2 ssl reuseport backlog=16384 , 0.0.0.0:9443 http2 ssl reuseport backlog=16384

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!