Size limits

Mutagen has two control parameters to limit 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 create command. This limit can be set on a default per-session basis by including the following in ~/mutagen.toml:

[sync]
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").

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 create command. This limit can be set on a default per-session basis by including the following in ~/.mutagen.toml:

[sync]
maxEntryCount = <count>

The count should be a positive integer value. A value of 0 indicates no limit.