Limits and Defaults Reference

Look up Shipfox gate attempt caps, job timeouts, log budgets and retention, output grouping caps, and environment-map limits.

This page is the canonical home for shared operational limits. Other pages describe the behavior and link here for the numbers. Self-hosted deployments can change the values marked configurable.

Workflow execution

Limit	Default	Configurable	Details
Gate attempts per gating step	3 (one initial run + two restarts)	No	When the cap is exhausted and the gate still fails, the step is marked failed and the job stops. See Feedback loops.
Job `execution_timeout`	6 hours	Per job, in YAML	Wall-clock bound on one job execution, including gate retries. See Job fields.
Run timeout	30 days	No (not authorable)	Outer bound on a whole run, including its listening jobs. A listening job's `timeout` is capped by it.
Manual triggers per workflow	1	No	See Trigger fields.

Step outputs

Limit	Default	Configurable	Details
Output bytes per step	64 KiB total, 16 KiB per value	No	Values past the cap fail the step's output parsing. See Step outputs.
Declared outputs per step	128 entries	No	The `outputs:` map on one step.
Agent output re-prompts	2	No	An agent step missing a declared output is re-prompted this many times before the step fails.

Workflow document

Limit	Default	Configurable	Details
`env` entries per map	128	No	Applies to each of the workflow, job, and step `env` maps. See Environment variables.
`env` serialized size	32 KiB	No	The JSON-serialized size of one `env` map.

Logs

Limit	Default	Configurable	Details
Per-job log budget	32 MiB + 1 MiB per minute	Self-host: `LOG_BUDGET_BASE_BYTES`, `LOG_BUDGET_RATE_BYTES_PER_MINUTE`	Past the budget, the job is capped and further output is dropped. A `capped` record marks the boundary. See Inspect logs.
Log retention	90 days	Self-host: `LOG_RETENTION_DAYS`	Persisted logs are deleted from the database and object storage after this window.
Output group nesting	32 levels	No	Past the cap a group is flattened into plain output. Wrap output in `::group::<name>` / `::endgroup::` marker lines to create collapsible sections.
Output group name	1 KiB	No	The runner byte-truncates longer marker names before upload. Direct log records over the cap are rejected at the record level.

Workflow schema

The fields these limits apply to.

Workflows and runs

How runs stream, persist, and bound their output.

Was this page helpful?

Edit this page on GitHub