Cloudflare Docs
Visit Support on GitHub
Set theme to dark (⇧+D)

Understanding Cloudflare gRPC support

​​ Overview

The gRPC protocol was developed by Google in 2015 to build efficient APIs with smaller payloads for reduced bandwidth usage, decreased latency, and faster implementations.  Cloudflare offers support for gRPC to protect your APIs on any orange-clouded gRPC endpoints.

Running gRPC traffic on Cloudflare is compatible with most Cloudflare products, including WAF, Bot Management, and Page Rules. gRPC support is available on all Cloudflare plans for no additional fees.  However, charges may occur for gRPC traffic over add-on products such as Argo Smart Routing, WAF, and Bot Management. gRPC support is broadly tested and considered stable, but bugs are still possible.  Report unexpected behaviors to Cloudflare Support.

​​ Requirements

  • Your gRPC endpoint must listen on port 443. 
  • Your gRPC endpoint must support TLS and HTTP/2.
  • HTTP/2 must be advertised over ALPN.
  • Use application/grpc or application/grpc+<message type (for example: application/grpc+proto) for the Content-Type header of gRPC requests.

​​ Limitations

The following products have limited capabilities with gRPC requests:

  • Cloudflare Tunnel currently does not support gRPC.
  • Cloudflare Access does not support gRPC traffic sent through Cloudflare’s reverse proxy. gRPC traffic will be ignored by Access if gRPC is enabled in Cloudflare. We recommend disabling gRPC for any sensitive origin servers protected by Access or enabling another means of authenticating gRPC traffic to your origin servers.

​​ Enable gRPC

Follow the instructions below to enable gRPC:

  1. Log in to your Cloudflare account.
  2. Select the appropriate domain.
  3. Click the Network app.
  4. Toggle the gRPC.