rclone --fast-list
--fast-list can cut listing overhead drastically on deep directories, but it trades API calls for memory. Use it as a measured optimization, not a blind default.
Use It When
- You sync many nested paths.
- Backend supports efficient recursive listing.
- Host has enough memory headroom.
Example
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --dry-run
Examples with Output
1. Fast-list profile example 1
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --dry-run
Expected output:
NOTICE: profile applied ()
Would transfer 57 files
2. Fast-list profile example 2
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --stats 15s --dry-run
Expected output:
NOTICE: profile applied (--stats 15s)
Would transfer 64 files
3. Fast-list profile example 3
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --stats 30s --dry-run
Expected output:
NOTICE: profile applied (--stats 30s)
Would transfer 71 files
4. Fast-list profile example 4
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --include "**/*.log" --dry-run
Expected output:
NOTICE: profile applied (--include "**/*.log")
Would transfer 78 files
5. Fast-list profile example 5
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --exclude "**/*.tmp" --dry-run
Expected output:
NOTICE: profile applied (--exclude "**/*.tmp")
Would transfer 85 files
6. Fast-list profile example 6
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --max-age 7d --dry-run
Expected output:
NOTICE: profile applied (--max-age 7d)
Would transfer 92 files
7. Fast-list profile example 7
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --max-size 200M --dry-run
Expected output:
NOTICE: profile applied (--max-size 200M)
Would transfer 99 files
8. Fast-list profile example 8
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --bwlimit 20M --dry-run
Expected output:
NOTICE: profile applied (--bwlimit 20M)
Would transfer 106 files
9. Fast-list profile example 9
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --tpslimit 8 --dry-run
Expected output:
NOTICE: profile applied (--tpslimit 8)
Would transfer 113 files
10. Fast-list profile example 10
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --checksum --dry-run
Expected output:
NOTICE: profile applied (--checksum)
Would transfer 120 files
11. Fast-list profile example 11
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --delete-excluded --dry-run
Expected output:
NOTICE: profile applied (--delete-excluded)
Would transfer 127 files
12. Fast-list profile example 12
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --progress --dry-run
Expected output:
NOTICE: profile applied (--progress)
Would transfer 134 files
13. Fast-list profile example 13
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --checkers 32 --dry-run
Expected output:
NOTICE: profile applied (--checkers 32)
Would transfer 141 files
14. Fast-list profile example 14
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --transfers 16 --dry-run
Expected output:
NOTICE: profile applied (--transfers 16)
Would transfer 148 files
15. Fast-list profile example 15
Input command:
rclone sync /srv/data remote:backup/data --fast-list --transfers 8 --checkers 16 --log-level INFO --dry-run
Expected output:
NOTICE: profile applied (--log-level INFO)
Would transfer 155 files