file-systems.rst.inc 1.1 KB

1234567891011121314151617181920212223242526
  1. File systems
  2. ~~~~~~~~~~~~
  3. We strongly recommend against using Borg (or any other database-like
  4. software) on non-journaling file systems like FAT, since it is not
  5. possible to assume any consistency in case of power failures (or a
  6. sudden disconnect of an external drive or similar failures).
  7. While Borg uses a data store that is resilient against these failures
  8. when used on journaling file systems, it is not possible to guarantee
  9. this with some hardware -- independent of the software used. We don't
  10. know a list of affected hardware.
  11. If you are suspicious whether your Borg repository is still consistent
  12. and readable after one of the failures mentioned above occurred, run
  13. ``borg check --verify-data`` to make sure it is consistent.
  14. .. rubric:: Requirements for Borg repository file systems
  15. - Long file names
  16. - At least three directory levels with short names
  17. - Typically, file sizes up to a few hundred MB.
  18. Large repositories may require large files (>2 GB).
  19. - Up to 1000 files per directory (10000 for repositories initialized with Borg 1.0)
  20. - mkdir(2) should be atomic, since it is used for locking
  21. - Hardlinks are needed for :ref:`borg_upgrade` ``--inplace``