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:

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 9 found this helpful



Article is closed for comments.