← Schema index / Config Reference
files schema
Canonical generated docsThis section is generated from
caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.Project file-cache size limits and image compression defaults.
| Field path | Type | Required | Default | Canonical description |
|---|---|---|---|---|
files | section | optional | Project file-cache size limits and image compression defaults. | |
└ files.max_file_size | string | optional | 5MB | Maximum final file size accepted by caco file add (e.g. 5MB, 5MiB, 5242880). |
└ files.image_handling | map | optional | Default image handling and compression policy for caco file add. | |
└ files.image_handling.default_behavior | string | optional | preserve | Default handling for image inputs: preserve, compress, or reject. |
└ files.image_handling.auto_compress | bool | optional | Explicitly enable or disable image compression before file-cache storage. | |
└ files.image_handling.compression_format | string | optional | jpeg | Output format when compression is active: jpeg, png, or webp. |
└ files.image_handling.compression_quality | u8 | optional | 85 | Compression quality in the inclusive range 1..=100. |
└ files.auto_sync | map | optional | Daemon-side periodic file-cache auto-sync policy. | |
└ files.auto_sync.enabled | bool | optional | false | Enable the daemon's periodic file-cache auto-sync so node-local/mobile uploads propagate to the mesh without a manual caco file sync. Defaults to false (opt-in). |
└ files.auto_sync.interval_secs | u64 | optional | 900 | Seconds between automatic file-cache syncs. Defaults to 900 (15 minutes); floored at a small minimum. |
└ files.auto_sync.mode | string | optional | both | Auto-sync mode: push, pull, or both. Defaults to both (matches caco file sync). |