GRPC API exposure

We are exposing a GRPC API and would like to perform rate limiting and access control. Do you support GRPC and/or HTTP/2 APIs?

1 Like


Due to the lack of support for upstream HTTP/2 and gRPC support, Kong currently does not offer support for proxying such APIs. Our mid/long term plans are to offer support for HTTP/2 and gRPC, but no timeline can be given at this point, sorry.

1 Like

Any update on gRPC support in Kong?

1 Like

At this time we are waiting for OpenResty to officially bump the underlying Nginx core to at least 1.13.10 (in which gRPC proxying support was added to Nginx) before releasing any related work. No further updates, but we are actively thinking and taking steps in that direction.

1 Like

An update on this, as we have some good news to share: OpenResty was released yesterday (see, so a 1.15 based Kong version is now in sight on the horizon.

We will make efforts to bump our OpenResty code and test subsequent OpenResty release candidates after our Kong 1.0 release (on which we are still working on).

If you feel like hacking around with Kong and gRPC, you can run Kong with this new OpenResty rc already, just make sure to update the following file so that Kong accepts the new OpenResty version:

And of course, tweak the nginx configuration file with some of the new ngx_http_grpc_module directives. If anybody is conducting any experiments on this, we would be curious to hear what you are up to!

Thank for your information. I would like to share my experience here.

First, I rebuilded OpenResty (according to agentzh’s comment here:, installed luarocks, and rebuilded Kong 1.0.0rc3 (followed basically) with modified meta.lua:

-    nginx = {""},
+    nginx = {""},

Then, modified /etc/kong/kong.conf

proxy_listen = http2, http2 ssl

Then, modified kong/templates/nginx_kong.lua

server {
    server_name kong;
    + location /{your_gRPC_package.your_gRPC_service} {
    +     grpc_pass; # forward to a gRPC server
    + }

to add a new location in Kong server to forward gRPC.

It works!

Sorry it might be too early, but have some questions about future plans for gRPC supports.

1. Will Kong support gRPC fowarding via the way of setting service and route?
Although now we can modify nginx_kong.lua to forward gRPC requests. It is a bit hacky and not that dynamic. I wonder if Kong would extend route configuration with new protocol: ‘grpc’? or other dynamic way?

2. Will rate-limit plugin work for gRPC service?
Assuming I create a gRPC server as Kong service, will rate-limit plugin be applicable to this service?

3. Will JWT plugin work for gRPC service?
If we add HTTP Authorization header in client gRPC requests, does it make JWT plugin work?

Thank you so much.


@supl Glad you gave this a try! And very happy that you got it to work :slight_smile:

Then, modified kong/templates/nginx_kong.lua

Don’t forget that you can use your own nginx configuration template which should be slightly more elegant than patching Kong’s source template.

Now, to answer some of your questions:

Will Kong support gRPC fowarding via the way of setting service and route?

Yes, that is our plan for the future (post 1.0 release, so most likely first half of 2019). We intend to natively support gRPC proxying, although it is still too early to talk about the planned underlying model changes for this. Don’t forget that OpenResty is hasn’t even started the proper release cycle, rc0 is still very early.

Will rate-limit plugin work for gRPC service?

So is our intent. When and how, it is too early to tell still.

Will JWT plugin work for gRPC service?

The answer here would be “maybe”. Hopefully. Again, it is very early to tell at this point, considering no work has started on our end (hence why I posted those above instructions, for any adventurous hackers). We are still focused on our 1.0 release.

Good job hacking around with Kong and gRPC!

I understood it is still early.
I’ll keep following.

Thank you for answering :slight_smile:

Hello everyone,

An update on this topic: as highlighted during our last community call on May 14th, we announced that Kong 1.3 will bundle OpenResty and provide out of the box support for gRPC proxying :tada:

Stay tuned, for Kong 1.3 should land late June/early July.