00_README.txt 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. Binary BorgBackup builds
  2. ========================
  3. The binaries are supposed to work on the specified platform without installing
  4. any dependencies.
  5. Download the correct files
  6. --------------------------
  7. AMD64/x86_64 architecture
  8. ~~~~~~~~~~~~~~~~~~~~~~~~~
  9. borg-linux-glibc241 Linux (built on Debian 13 "Trixie" with glibc 2.41)
  10. borg-linux-glibc236 Linux (built on Debian 12 "Bookworm" with glibc 2.36)
  11. borg-linux-glibc231 Linux (built on Debian 11 "Bullseye" with glibc 2.31)
  12. Note: You can also try them on other Linux distributions with different glibc
  13. versions - as long as glibc is compatible, they will work.
  14. If it does not work, try a Borg 1.4.x or 1.2.x binary.
  15. borg-macos1012 macOS (built on macOS Sierra 10.12 with the latest macFUSE from Homebrew)
  16. To avoid signing issues, download the file via the command line or
  17. remove the "quarantine" attribute after downloading:
  18. $ xattr -dr com.apple.quarantine borg-macos1012.tgz
  19. borg-freebsd14 FreeBSD (built on FreeBSD 14)
  20. *.tgz Similar to the above, but built as a directory with files,
  21. not as a single self-extracting binary. Using the directory
  22. build is faster and does not require as much space in the temporary
  23. directory as the one-file build.
  24. *.asc GnuPG signatures for the files
  25. Verifying your download
  26. -----------------------
  27. Please check the GPG signature to make sure you received the binary as I have
  28. built it.
  29. To check the GPG signature, download both the binary and the corresponding
  30. *.asc file and then (on the shell) type, for example:
  31. gpg --recv-keys 9F88FB52FAF7B393
  32. gpg --verify borg-freebsd14.asc borg-freebsd14
  33. The files are signed by:
  34. Thomas Waldmann <tw@waldmann-edv.de>
  35. GPG key fingerprint: 6D5B EF9A DD20 7580 5747 B70F 9F88 FB52 FAF7 B393
  36. My fingerprint is also in the footer of all my BorgBackup mailing list posts.
  37. Installing
  38. ----------
  39. It is suggested that you rename or symlink the binary to just "borg".
  40. If you need "borgfs", just also symlink it to the same binary; it will
  41. detect internally under which name it was invoked.
  42. On UNIX-like platforms, /usr/local/bin/ or ~/bin/ is a nice place for it,
  43. but you can invoke it from anywhere by providing the full path to it.
  44. Make sure the file is readable and executable (chmod +rx borg on UNIX-like
  45. platforms).
  46. Reporting issues
  47. ----------------
  48. Please first check the FAQ and whether a GitHub issue already exists.
  49. If you find a NEW issue, please open a ticket on our issue tracker:
  50. https://github.com/borgbackup/borg/issues/
  51. There, please give:
  52. - the version number (it is displayed if you invoke borg -V)
  53. - the sha256sum of the binary
  54. - a good description of what the issue is
  55. - a good description of how to reproduce your issue
  56. - a traceback with system info (if you have one)
  57. - your precise platform (CPU, 32/64-bit?), OS, distribution, release
  58. - your Python and (g)libc versions