How-To: Handle large http body requests

Configure http requests that are bigger than 4 MB

By default, Dapr has a limit for the request body size, set to 4MB. You can change this by defining:

  • The dapr.io/http-max-request-size annotation, or
  • The --dapr-http-max-request-size flag.

When running in self-hosted mode, use the --dapr-http-max-request-size flag to configure Dapr to use non-default request body size:

dapr run --dapr-http-max-request-size 16 node app.js

This tells Dapr to set maximum request body size to 16 MB.


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-max-request-size: "16"
#...

Dapr Kubernetes pod annotations spec

Next steps

Install sidecar certificates

Last modified September 8, 2025: fix: update Redis documentation to reference latest Sentinel documentation links (#4860) (938c81b)