Deployment configuration
Deployment configuration
The Orchestration Cluster REST API supports file and multipart uploads when deploying BPMN diagrams and other resources. By default, the maximum allowed request size is 4MB. You can increase this limit in Self-Managed cluster through configuration of the Zeebe Gateway, Broker, and the REST layer (e.g. Spring Boot + Tomcat).
This guide walks you through adjusting these settings.
Gateway and Broker configuration
The maxMessageSize default value is 4MB. You can configure this setting in the:
If you increase this value, you must also adjust the configuration for the deployment REST endpoint to match.
REST API server configuration
If you're using the REST API and submitting files via multipart upload (e.g., using POST /v2/deployments), make sure your application is configured to accept the updated request sizes. If you increase the maxMessageSize to 10MB, increase these property values to 10MB as well.
For Spring Boot applications:
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB
Tomcat multipart settings
Tomcat, which underlies many Java web applications, also applies multipart limits. If you're uploading multiple files as part of a multipart request, note that Tomcat limits the number of parts per request using the server.tomcat.max-part-count property. By default, this is set to 50 in the orchestration API. You can increase the limit to allow more files by setting the property in your configuration:
server.tomcat.max-part-count=100
or using an environment variable:
SERVER_TOMCAT_MAX_PART_COUNT=100
The default is 50 in the orchestration API layer.
Max parameter count
Tomcat also enforces a separate limit on the total number of request parameters via the server.tomcat.max-parameter-count property. Since each file upload typically counts as both a part and a parameter, the lower of these two limits will determine how many files can be uploaded.
Reference
For more information on defaults and options, refer to the Apache Tomcat documentation.