Maximum Size of a CircleCI Configuration File (config.yml)

Exceeding 3MB Max Config Size

The maximum size of a CircleCI configuration file (config.yml) is 3MB. When this limit is exceeded, customers may see errors such as "Unexpected exception processing config" or "A compiled config YAML must be at most 3MB" or "Error: Your config (including expanded orbs) is too large. Please contact support." in their build logs.

It is important to remember that this is the compiled configuration. This is the result of expanding any YAML anchors and aliases as well as expanding any included Orbs.

To find out what is the final or compiled configuration, use the CircleCI CLI to process the original config.

From there, you can inspect the compiled configuration file size using the commands below:

# NOTE that the command below will fail if 
# your compiled YAML file exceeds the 3MB limit.
# These commands are meant to help you figure out if
# your current config is nearing the 3MB limit.

circleci config process .circleci/config.yml
> compiled.yml

ls -lH compiled.yml

Please check out our tips on configuration here, as they include ideas on keeping your config file compact.


Was this article helpful?
2 out of 11 found this helpful



Article is closed for comments.