Back to Activepieces

Technical Limits

docs/flows/known-limits.mdx

0.84.03.8 KB
Original Source
<Note> The numbers in the **Cloud** column are the limits enforced on [cloud.activepieces.com](https://cloud.activepieces.com). On **self-hosted** installations every limit is configurable through the environment variable shown in the table — the **Self-hosted default** column lists the value applied when the variable is unset. </Note>

Execution

LimitCloudEnv varSelf-hosted default
Flow run timeout10 minAP_FLOW_TIMEOUT_SECONDS600
Worker process memory1 GBAP_SANDBOX_MEMORY_LIMIT (KB)1048576
Paused flow lifetime30 daysAP_PAUSED_FLOW_TIMEOUT_DAYS30
Worker concurrency (per worker)10AP_WORKER_CONCURRENCY5
<Tip> Flows paused by **Wait for Approval** or **Delay** do **not** count toward the flow run timeout — the timeout only counts active execution time. </Tip> <Tip> The memory limit is measured for the entire Node.js process running the flow. About 300 MB of that is overhead for a warm process with pieces loaded. </Tip> <Tip> To handle longer processes, split them into multiple flows — e.g. one flow calls another via webhook, or each flow processes a smaller batch of items. </Tip>

Files & flow run logs

<Info> Files emitted by actions or triggers are persisted to the database or S3 so the flow can retry from a later step. The log size limit applies to the combined inputs and outputs of every step in a single run; step outputs above the slice threshold are offloaded to object storage and re-hydrated on demand instead of sitting in worker memory. </Info>
LimitCloudEnv varSelf-hosted default
Step file size10 MBAP_MAX_FILE_SIZE_MB25
Flow run log size (combined inputs + outputs, includes sliced payloads)25 MBAP_MAX_FLOW_RUN_LOG_SIZE_MB50
Step output slice threshold32 KBAP_FLOW_RUN_LOG_SLICE_THRESHOLD_KB32
Step input truncate threshold2 KBAP_FLOW_RUN_LOG_INPUT_TRUNCATE_THRESHOLD_KB2

How it works

  • Input — values above AP_FLOW_RUN_LOG_INPUT_TRUNCATE_THRESHOLD_KB are replaced with a placeholder in the log; the step still receives the full value at runtime.
  • Output — outputs above AP_FLOW_RUN_LOG_SLICE_THRESHOLD_KB are offloaded to object storage and replaced with a reference in the log; the payload is re-hydrated on demand.
  • Total — the cumulative size of inputs and outputs (counting the original size of offloaded outputs) is capped by AP_MAX_FLOW_RUN_LOG_SIZE_MB. Runs that exceed it end with status LOG_SIZE_EXCEEDED.
<Warning> A run that produces enough cumulative output to exceed `AP_MAX_FLOW_RUN_LOG_SIZE_MB` ends with status `LOG_SIZE_EXCEEDED`, regardless of how many individual outputs were offloaded to object storage. Lowering `AP_FLOW_RUN_LOG_SLICE_THRESHOLD_KB` will not buy more log headroom — only raising `AP_MAX_FLOW_RUN_LOG_SIZE_MB` does. </Warning>

Webhooks

LimitCloudEnv varSelf-hosted default
Sync webhook response timeout30 sAP_WEBHOOK_TIMEOUT_SECONDS30
Max webhook payload size5 MBAP_MAX_WEBHOOK_PAYLOAD_SIZE_MB25
Webhook payload inline threshold1024 KBAP_WEBHOOK_PAYLOAD_INLINE_THRESHOLD_KB512
<Tip> For synchronous webhook requests (URLs ending in `/sync`), Activepieces will wait up to the response timeout before returning HTTP 408. Payloads above the inline threshold are offloaded from Redis to file storage to protect Redis memory; smaller payloads stay inline for the fastest path. </Tip>

Key / value storage

Used by the built-in Store piece and any piece that calls context.store.

LimitValue
Maximum key length128 characters
Maximum value size512 KB

These limits are not configurable.