Skip to main content

Performance and Transfers Cheatsheet

This cheatsheet is the operational map for the restructured performance module. Use it to pick safe baseline profiles quickly during tuning, incidents, and routine maintenance.

05-performance-and-transfers/
├── transfers-checkers-and-fast-list/
│   ├── transfers/
│   ├── checkers/
│   └── fast-list/
├── bandwidth-and-concurrency-tuning/
│   ├── bandwidth/
│   ├── concurrency/
│   └── tpslimit/
└── retries-timeouts-and-large-files/
    ├── retries/
    ├── timeouts/
    └── large-files/

Fast Tuning Matrix​

GoalPrimary flagsStarter pattern
Throughput--transfers, --checkers--transfers 8 --checkers 16
Deep tree listing speed--fast-list--fast-list
Network protection--bwlimit--bwlimit 20M
API throttle control--tpslimit--tpslimit 8
Resilience--retries, --retries-sleep, --low-level-retries--retries 8 --retries-sleep 10s --low-level-retries 20
Link stability--contimeout, --timeout--contimeout 30s --timeout 5m

Safe Baseline Command​

rclone sync /srv/data remote:backup/data \
  --transfers 8 --checkers 16 --fast-list \
  --bwlimit 20M --tpslimit 8 \
  --retries 8 --retries-sleep 10s --low-level-retries 20 \
  --contimeout 30s --timeout 5m \
  --dry-run -vv

Preflight​

  • Start conservative, then scale up after clean runs.
  • Tune one dimension at a time (transfers, then checkers, then bwlimit/tpslimit).
  • Keep --dry-run -vv and logs during profile changes.

Examples with Output​

1. Cheatsheet profile example 1​

Input command:

rclone sync /srv/data remote:backup/data --transfers 4 --checkers 8 --bwlimit 10M --tpslimit 4 --dry-run

Expected output:

NOTICE: profile applied (--transfers 4 --checkers 8 --bwlimit 10M --tpslimit 4)
Would transfer 57 files

2. Cheatsheet profile example 2​

Input command:

rclone sync /srv/data remote:backup/data --transfers 6 --checkers 12 --bwlimit 15M --tpslimit 6 --dry-run

Expected output:

NOTICE: profile applied (--transfers 6 --checkers 12 --bwlimit 15M --tpslimit 6)
Would transfer 64 files

3. Cheatsheet profile example 3​

Input command:

rclone sync /srv/data remote:backup/data --transfers 8 --checkers 16 --bwlimit 20M --tpslimit 8 --dry-run

Expected output:

NOTICE: profile applied (--transfers 8 --checkers 16 --bwlimit 20M --tpslimit 8)
Would transfer 71 files

4. Cheatsheet profile example 4​

Input command:

rclone sync /srv/data remote:backup/data --transfers 10 --checkers 20 --bwlimit 25M --tpslimit 10 --dry-run

Expected output:

NOTICE: profile applied (--transfers 10 --checkers 20 --bwlimit 25M --tpslimit 10)
Would transfer 78 files

5. Cheatsheet profile example 5​

Input command:

rclone sync /srv/data remote:backup/data --transfers 12 --checkers 24 --bwlimit 30M --tpslimit 10 --dry-run

Expected output:

NOTICE: profile applied (--transfers 12 --checkers 24 --bwlimit 30M --tpslimit 10)
Would transfer 85 files

6. Cheatsheet profile example 6​

Input command:

rclone sync /srv/data remote:backup/data --transfers 14 --checkers 28 --bwlimit 40M --tpslimit 12 --dry-run

Expected output:

NOTICE: profile applied (--transfers 14 --checkers 28 --bwlimit 40M --tpslimit 12)
Would transfer 92 files

7. Cheatsheet profile example 7​

Input command:

rclone sync /srv/data remote:backup/data --transfers 16 --checkers 32 --bwlimit 50M --tpslimit 12 --dry-run

Expected output:

NOTICE: profile applied (--transfers 16 --checkers 32 --bwlimit 50M --tpslimit 12)
Would transfer 99 files

8. Cheatsheet profile example 8​

Input command:

rclone sync /srv/data remote:backup/data --transfers 8 --checkers 16 --fast-list --retries 8 --retries-sleep 10s --dry-run

Expected output:

NOTICE: profile applied (--transfers 8 --checkers 16 --fast-list --retries 8 --retries-sleep 10s)
Would transfer 106 files

9. Cheatsheet profile example 9​

Input command:

rclone sync /srv/data remote:backup/data --transfers 8 --checkers 16 --fast-list --contimeout 30s --timeout 5m --dry-run

Expected output:

NOTICE: profile applied (--transfers 8 --checkers 16 --fast-list --contimeout 30s --timeout 5m)
Would transfer 113 files

10. Cheatsheet profile example 10​

Input command:

rclone sync /srv/data remote:backup/data --transfers 4 --checkers 8 --retries 12 --low-level-retries 20 --timeout 8m --dry-run

Expected output:

NOTICE: profile applied (--transfers 4 --checkers 8 --retries 12 --low-level-retries 20 --timeout 8m)
Would transfer 120 files

11. Cheatsheet profile example 11​

Input command:

rclone sync /srv/data remote:backup/data --transfers 6 --checkers 12 --bwlimit 0 --tpslimit 15 --dry-run

Expected output:

NOTICE: profile applied (--transfers 6 --checkers 12 --bwlimit 0 --tpslimit 15)
Would transfer 127 files

12. Cheatsheet profile example 12​

Input command:

rclone sync /srv/data remote:backup/data --transfers 8 --checkers 16 --max-size 1G --retries 10 --timeout 10m --dry-run

Expected output:

NOTICE: profile applied (--transfers 8 --checkers 16 --max-size 1G --retries 10 --timeout 10m)
Would transfer 134 files

13. Cheatsheet profile example 13​

Input command:

rclone sync /srv/data remote:backup/data --transfers 12 --checkers 24 --checksum --bwlimit 25M --dry-run

Expected output:

NOTICE: profile applied (--transfers 12 --checkers 24 --checksum --bwlimit 25M)
Would transfer 141 files

14. Cheatsheet profile example 14​

Input command:

rclone sync /srv/data remote:backup/data --transfers 6 --checkers 12 --backup-dir remote:backup/rollback/$(date +%F-%H%M) --dry-run

Expected output:

NOTICE: profile applied (--transfers 6 --checkers 12 --backup-dir remote:backup/rollback/$(date +%F-%H%M))
Would transfer 148 files

15. Cheatsheet profile example 15​

Input command:

rclone sync /srv/data remote:backup/data --transfers 8 --checkers 16 --log-level INFO --stats 30s --dry-run

Expected output:

NOTICE: profile applied (--transfers 8 --checkers 16 --log-level INFO --stats 30s)
Would transfer 155 files

Next​