Size limits

Mutagen has two session configuration parameters to limit synchronization disk usage.

Maximum staging file size

The maximum file size that Mutagen will allow to be staged (transferred) can be set on a per-session basis by passing the --max-staging-file-size=<size> flag to the mutagen sync create command. This limit can be set on a default per-session basis by including the following in ~/mutagen.yml:

sync:
  defaults:
    maxStagingFileSize: <size>

Size specifications can be provided as a numeric value representing byte count or as a string using human-friendly units (e.g. "1000 GB"). A value of 0 (the default) indicates a limit of 264-1 bytes.

Maximum entry count

The maximum entry count (i.e. the total count of directories, files, and symbolic links in a synchronization root) that Mutagen will process is unlimited by default, but can be set on a per-session basis by passing the --max-entry-count=<count> flag to the mutagen sync create command. This limit can be set on a default per-session basis by including the following in ~/.mutagen.yml:

sync:
  defaults:
    maxEntryCount: <count>

The count should be a positive integer value. A value of 0 (the default) indicates a limit of 264-1 entries.