file-systems.rst.inc 1.3 KB

12345678910111213141516171819202122232425262728
  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` (if ``--inplace`` option is not used).
  22. Also hardlinks are used for more safe and secure file updating (e.g. of the repo
  23. config file), but the code tries to work also if hardlinks are not supported.