How-To: Handle large http header size

Configure a larger http read buffer size

Dapr has a default limit of 4KB for the http header read buffer size. When sending http headers that are bigger than the default 4KB, you can increase this value. Otherwise, you may encounter a Too big request header service invocation error. You can change the http header size by using the dapr.io/http-read-buffer-size annotation or --dapr-http-read-buffer-size flag when using the CLI.

• Self-hosted
• Kubernetes

When running in self hosted mode, use the --dapr-http-read-buffer-size flag to configure Dapr to use non-default http header size:

dapr run --dapr-http-read-buffer-size 16 node app.js

This tells Dapr to set maximum read buffer size to 16 KB.

On Kubernetes, set the following annotations in your deployment YAML:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
  namespace: default
  labels:
    app: myapp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
      annotations:
        dapr.io/enabled: "true"
        dapr.io/app-id: "myapp"
        dapr.io/app-port: "8000"
        dapr.io/http-read-buffer-size: "16"
...

Related links

• Dapr Kubernetes pod annotations spec

Last modified October 12, 2023: Update config.toml (#3826) (0ffc2e7)