Simple, configuration-driven backup software for servers and workstations https://torsion.org/borgmatic/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408
  1. 1.3.14
  2. * #204: Do not treat Borg warnings (exit code 1) as failures.
  3. * When validating configuration files, require strings instead of allowing any scalar type.
  4. 1.3.13
  5. * #199: Add note to documentation about using spaces instead of tabs for indentation, as YAML does
  6. not allow tabs.
  7. * #203: Fix compatibility with ruamel.yaml 0.16.x.
  8. * If a "prefix" option in borgmatic's configuration has an empty value (blank or ""), then disable
  9. default prefix.
  10. 1.3.12
  11. * Only log to syslog when run from a non-interactive console (e.g. a cron job).
  12. * Remove unicode byte order mark from syslog output so it doesn't show up as a literal in rsyslog
  13. output. See discussion on #197.
  14. 1.3.11
  15. * #193: Pass through several "borg list" and "borg info" flags like --short, --format, --sort-by,
  16. --first, --last, etc. via borgmatic command-line flags.
  17. * Add borgmatic info --repository and --archive command-line flags to display info for individual
  18. repositories or archives.
  19. * Support for Borg --noatime, --noctime, and --nobirthtime flags via corresponding options in
  20. borgmatic configuration location section.
  21. 1.3.10
  22. * #198: Fix for Borg create error output not showing up at borgmatic verbosity level zero.
  23. 1.3.9
  24. * #195: Switch to command-line actions as more traditional sub-commands, e.g. "borgmatic create",
  25. "borgmatic prune", etc. However, the classic dashed options like "--create" still work!
  26. 1.3.8
  27. * #191: Disable console color via "color" option in borgmatic configuration output section.
  28. 1.3.7
  29. * #196: Fix for unclear error message for invalid YAML merge include.
  30. * #197: Don't color syslog output.
  31. * Change default syslog verbosity to show errors only.
  32. 1.3.6
  33. * #53: Log to syslog in addition to existing console logging. Add --syslog-verbosity flag to
  34. customize the log level. See the documentation for more information:
  35. https://torsion.org/borgmatic/docs/how-to/inspect-your-backups/
  36. * #178: Look for .yml configuration file extension in addition to .yaml.
  37. * #189: Set umask used when executing hooks via "umask" option in borgmatic hooks section.
  38. * Remove Python cache files before each Tox run.
  39. * Add #borgmatic Freenode IRC channel to documentation.
  40. * Add Borg/borgmatic hosting providers section to documentation.
  41. * Add files for building documentation into a Docker image for web serving.
  42. * Upgrade project build server from Drone 0.8 to 1.1.
  43. * Build borgmatic documentation during continuous integration.
  44. * We're nearly at 500 ★s on GitHub. We can do this!
  45. 1.3.5
  46. * #153: Support for various Borg directory environment variables (BORG_CONFIG_DIR, BORG_CACHE_DIR,
  47. etc.) via options in borgmatic's storage configuration.
  48. * #177: Fix for regression with missing verbose log entries.
  49. 1.3.4
  50. * Part of #125: Color borgmatic (but not Borg) output when using an interactive terminal.
  51. * #166: Run tests for all installed versions of Python.
  52. * #168: Update README with continuous integration badge.
  53. * #169: Automatically sort Python imports in code.
  54. * Document installing borgmatic with pip install --user instead of a system Python install.
  55. * Get more reproducible builds by pinning the versions of pip and tox used to run tests.
  56. * Factor out build/test configuration from tox.ini file.
  57. 1.3.3
  58. * Add validate-borgmatic-config command, useful for validating borgmatic config generated by
  59. configuration management or even edited by hand.
  60. 1.3.2
  61. * #160: Fix for hooks executing when using --dry-run. Now hooks are skipped during a dry run.
  62. 1.3.1
  63. * #155: Fix for invalid JSON output when using multiple borgmatic configuration files.
  64. * #157: Fix for seemingly random filename ordering when running through a directory of
  65. configuration files.
  66. * Fix for empty JSON output when using --create --json.
  67. * Now capturing Borg output only when --json flag is used. Previously, borgmatic delayed Borg
  68. output even without the --json flag.
  69. 1.3.0
  70. * #148: Configuration file includes and merging via "!include" tag to support reuse of common
  71. options across configuration files.
  72. 1.2.18
  73. * #147: Support for Borg create/extract --numeric-owner flag via "numeric_owner" option in
  74. borgmatic's location section.
  75. 1.2.17
  76. * #140: List the files within an archive via --list --archive option.
  77. 1.2.16
  78. * #119: Include a sample borgmatic configuration file in the documentation.
  79. * #123: Support for Borg archive restoration via borgmatic --extract command-line flag.
  80. * Refactor documentation into multiple separate pages for clarity and findability.
  81. * Organize options within command-line help into logical groups.
  82. * Exclude tests from distribution packages.
  83. 1.2.15
  84. * #127: Remove date echo from schema example, as it's not a substitute for real logging.
  85. * #132: Leave exclude_patterns glob expansion to Borg, since doing it in borgmatic leads to
  86. confusing behavior.
  87. * #136: Handle and format validation errors raised during argument parsing.
  88. * #138: Allow use of --stats flag when --create or --prune flags are implied.
  89. 1.2.14
  90. * #103: When generating sample configuration with generate-borgmatic-config, document the defaults
  91. for each option.
  92. * #116: When running multiple configuration files, attempt all configuration files even if one of
  93. them errors. Log a summary of results at the end.
  94. * Add borgmatic --version command-line flag to get the current installed version number.
  95. 1.2.13
  96. * #100: Support for --stats command-line flag independent of --verbosity.
  97. * #117: With borgmatic --init command-line flag, proceed without erroring if a repository already
  98. exists.
  99. 1.2.12
  100. * #110: Support for Borg repository initialization via borgmatic --init command-line flag.
  101. * #111: Update Borg create --filter values so a dry run lists files to back up.
  102. * #113: Update README with link to a new/forked Docker image.
  103. * Prevent deprecated --excludes command-line option from being used.
  104. * Refactor README a bit to flow better for first-time users.
  105. * Update README with a few additional borgmatic packages (Debian and Ubuntu).
  106. 1.2.11
  107. * #108: Support for Borg create --progress via borgmatic command-line flag.
  108. 1.2.10
  109. * #105: Support for Borg --chunker-params create option via "chunker_params" option in borgmatic's
  110. storage section.
  111. 1.2.9
  112. * #102: Fix for syntax error that occurred in Python 3.5 and below.
  113. * Make automated tests support running in Python 3.5.
  114. 1.2.8
  115. * #73: Enable consistency checks for only certain repositories via "check_repositories" option in
  116. borgmatic's consistency configuration. Handy for large repositories that take forever to check.
  117. * Include link to issue tracker within various command output.
  118. * Run continuous integration tests on a matrix of Python and Borg versions.
  119. 1.2.7
  120. * #98: Support for Borg --keep-secondly prune option.
  121. * Use Black code formatter and Flake8 code checker as part of running automated tests.
  122. * Add an end-to-end automated test that actually integrates with Borg.
  123. * Set up continuous integration for borgmatic automated tests on projects.evoworx.org.
  124. 1.2.6
  125. * Fix generated configuration to also include a "keep_daily" value so pruning works out of the
  126. box.
  127. 1.2.5
  128. * #57: When generating sample configuration with generate-borgmatic-config, comment out all
  129. optional configuration so as to streamline the initial configuration process.
  130. 1.2.4
  131. * Fix for archive checking traceback due to parameter mismatch.
  132. 1.2.3
  133. * #64, #90, #92: Rewrite of logging system. Now verbosity flags passed to Borg are derived from
  134. borgmatic's log level. Note that the output of borgmatic might slightly change.
  135. * Part of #80: Support for Borg create --read-special via "read_special" option in borgmatic's
  136. location configuration.
  137. * #87: Support for Borg create --checkpoint-interval via "checkpoint_interval" option in
  138. borgmatic's storage configuration.
  139. * #88: Fix declared pykwalify compatibility version range in setup.py to prevent use of ancient
  140. versions of pykwalify with large version numbers.
  141. * #89: Pass --show-rc option to Borg when at highest verbosity level.
  142. * #94: Support for Borg --json option via borgmatic command-line to --create archives.
  143. 1.2.2
  144. * #85: Fix compatibility issue between pykwalify and ruamel.yaml 0.15.52, which manifested in
  145. borgmatic as a pykwalify RuleError.
  146. 1.2.1
  147. * Skip before/after backup hooks when only doing --prune, --check, --list, and/or --info.
  148. * #71: Support for XDG_CONFIG_HOME environment variable for specifying alternate user ~/.config/
  149. path.
  150. * #74, #83: Support for Borg --json option via borgmatic command-line to --list archives or show
  151. archive --info in JSON format, ideal for programmatic consumption.
  152. * #38, #76: Upgrade ruamel.yaml compatibility version range and fix support for Python 3.7.
  153. * #77: Skip non-"*.yaml" config filenames in /etc/borgmatic.d/ so as not to parse backup files,
  154. editor swap files, etc.
  155. * #81: Document user-defined hooks run before/after backup, or on error.
  156. * Add code style guidelines to the documention.
  157. 1.2.0
  158. * #61: Support for Borg --list option via borgmatic command-line to list all archives.
  159. * #61: Support for Borg --info option via borgmatic command-line to display summary information.
  160. * #62: Update README to mention other ways of installing borgmatic.
  161. * Support for Borg --prefix option for consistency checks via "prefix" option in borgmatic's
  162. consistency configuration.
  163. * Add introductory screencast link to documentation.
  164. * #59: Ignore "check_last" and consistency "prefix" when "archives" not in consistency checks.
  165. * #60: Add "Persistent" flag to systemd timer example.
  166. * #63: Support for Borg --nobsdflags option to skip recording bsdflags (e.g. NODUMP, IMMUTABLE) in
  167. archive.
  168. * #69: Support for Borg prune --umask option using value of existing "umask" option in borgmatic's
  169. storage configuration.
  170. * Update tox.ini to only assume Python 3.x instead of Python 3.4 specifically.
  171. * Add ~/.config/borgmatic/config.yaml to default configuration path probing.
  172. * Document how to develop on and contribute to borgmatic.
  173. 1.1.15
  174. * Support for Borg BORG_PASSCOMMAND environment variable to read a password from an external file.
  175. * Fix for Borg create error when using borgmatic's --dry-run and --verbosity options together.
  176. Work-around for behavior introduced in Borg 1.1.3: https://github.com/borgbackup/borg/issues/3298
  177. * #55: Fix for missing tags/releases on Gitea and GitHub project hosting.
  178. * #56: Support for Borg --lock-wait option for the maximum wait for a repository/cache lock.
  179. * #58: Support for using tilde in exclude_patterns to reference home directory.
  180. 1.1.14
  181. * #49: Fix for typo in --patterns-from option.
  182. * #47: Support for Borg --dry-run option via borgmatic command-line.
  183. 1.1.13
  184. * #54: Fix for incorrect consistency check flags passed to Borg when all three checks ("repository",
  185. "archives", and "extract") are specified in borgmatic configuration.
  186. * #48: Add "local_path" to configuration for specifying an alternative Borg executable path.
  187. * #49: Support for Borg experimental --patterns-from and --patterns options for specifying mixed
  188. includes/excludes.
  189. * Moved issue tracker from Taiga to integrated Gitea tracker at
  190. https://projects.torsion.org/witten/borgmatic/issues
  191. 1.1.12
  192. * #46: Declare dependency on pykwalify 1.6 or above, as older versions yield "Unknown key: version"
  193. rule errors.
  194. * Support for Borg --keep-minutely prune option.
  195. 1.1.11
  196. * #26: Add "ssh_command" to configuration for specifying a custom SSH command or options.
  197. * Fix for incorrect /etc/borgmatic.d/ configuration path probing on macOS. This problem manifested
  198. as an error on startup: "[Errno 2] No such file or directory: '/etc/borgmatic.d'".
  199. 1.1.10
  200. * Pass several Unix signals through to child processes like Borg. This means that Borg now properly
  201. shuts down if borgmatic is terminated (e.g. due to a system suspend).
  202. * #30: Support for using tilde in repository paths to reference home directory.
  203. * #43: Support for Borg --files-cache option for setting the files cache operation mode.
  204. * #45: Support for Borg --remote-ratelimit option for limiting upload rate.
  205. * Log invoked Borg commands when at highest verbosity level.
  206. 1.1.9
  207. * #17, #39: Support for user-defined hooks before/after backup, or on error.
  208. * #34: Improve clarity of logging spew at high verbosity levels.
  209. * #30: Support for using tilde in source directory path to reference home directory.
  210. * Require "prefix" in retention section when "archive_name_format" is set. This is to avoid
  211. accidental pruning of archives with a different archive name format. For similar reasons, default
  212. "prefix" to "{hostname}-" if not specified.
  213. * Convert main source repository from Mercurial to Git.
  214. * Update dead links to Borg documentation.
  215. 1.1.8
  216. * #40: Fix to make /etc/borgmatic/config.yaml optional rather than required when using the default
  217. config paths.
  218. 1.1.7
  219. * #29: Add "archive_name_format" to configuration for customizing archive names.
  220. * Fix for traceback when "exclude_from" value is empty in configuration file.
  221. * When pruning, make highest verbosity level list archives kept and pruned.
  222. * Clarification of Python 3 pip usage in documentation.
  223. 1.1.6
  224. * #13, #36: Support for Borg --exclude-from, --exclude-caches, and --exclude-if-present options.
  225. 1.1.5
  226. * #35: New "extract" consistency check that performs a dry-run extraction of the most recent
  227. archive.
  228. 1.1.4
  229. * #18: Added command-line flags for performing a borgmatic run with only pruning, creating, or
  230. checking enabled. This supports use cases like running consistency checks from a different cron
  231. job with a different frequency, or running pruning with a different verbosity level.
  232. 1.1.3
  233. * #15: Support for running multiple config files in /etc/borgmatic.d/ from a single borgmatic run.
  234. * Fix for generate-borgmatic-config writing config with invalid one_file_system value.
  235. 1.1.2
  236. * #33: Fix for passing check_last as integer to subprocess when calling Borg.
  237. 1.1.1
  238. * Part of #33: Fix for upgrade-borgmatic-config converting check_last option as a string instead of
  239. an integer.
  240. * Fix for upgrade-borgmatic-config erroring when consistency checks option is not present.
  241. 1.1.0
  242. * Switched config file format to YAML. Run upgrade-borgmatic-config to upgrade.
  243. * Added generate-borgmatic-config command for initial config creation.
  244. * Dropped Python 2 support. Now Python 3 only.
  245. * #19: Fix for README mention of sample files not included in package.
  246. * #23: Sample files for triggering borgmatic from a systemd timer.
  247. * Support for backing up to multiple repositories.
  248. * To free up space, now pruning backups prior to creating a new backup.
  249. * Enabled test coverage output during tox runs.
  250. * Added logo.
  251. 1.0.3
  252. * #22: Fix for verbosity flag not actually causing verbose output.
  253. 1.0.2
  254. * #21: Fix for traceback when remote_path option is missing.
  255. 1.0.1
  256. * #20: Support for Borg's --remote-path option to use an alternate Borg
  257. executable. See sample/config.
  258. 1.0.0
  259. * Attic is no longer supported, as there hasn't been any recent development on
  260. it. Dropping Attic support will allow faster iteration on Borg-specific
  261. features. If you're still using Attic, this is a good time to switch to Borg!
  262. * Project renamed from atticmatic to borgmatic. See the borgmatic README for
  263. information on upgrading.
  264. 0.1.8
  265. * Fix for handling of spaces in source_directories which resulted in backup up everything.
  266. * Fix for broken links to Borg documentation.
  267. * At verbosity zero, suppressing Borg check stderr spew about "Checking segments".
  268. * Support for Borg --one-file-system.
  269. * Support for Borg create --umask.
  270. * Support for file globs in source_directories.
  271. 0.1.7
  272. * #12: Fixed parsing of punctuation in configuration file.
  273. * Better error message when configuration file is missing.
  274. 0.1.6
  275. * #10: New configuration option for the encryption passphrase.
  276. * #11: Support for Borg's new archive compression feature.
  277. 0.1.5
  278. * Changes to support release on PyPI. Now pip installable by name!
  279. 0.1.4
  280. * Adding test that setup.py version matches release version.
  281. 0.1.3
  282. * #2: Add support for "borg check --last N" to Borg backend.
  283. 0.1.2
  284. * As a convenience to new users, allow a missing default excludes file.
  285. * New issue tracker, linked from documentation.
  286. 0.1.1
  287. * Adding borgmatic cron example, and updating documentation to refer to it.
  288. 0.1.0
  289. * New "borgmatic" command to support Borg backup software, a fork of Attic.
  290. 0.0.7
  291. * Flag for multiple levels of verbosity: some, and lots.
  292. * Improved mocking of Python builtins in unit tests.
  293. 0.0.6
  294. * New configuration section for customizing which Attic consistency checks run, if any.
  295. 0.0.5
  296. * Fixed regression with --verbose output being buffered. This means dropping the helpful error
  297. message introduced in 0.0.4.
  298. 0.0.4
  299. * Now using tox to run tests against multiple versions of Python in one go.
  300. * Helpful error message about how to create a repository if one is missing.
  301. * Troubleshooting section with steps to deal with broken pipes.
  302. * Nosetests config file (setup.cfg) with defaults.
  303. 0.0.3
  304. * After pruning, run attic's consistency checks on all archives.
  305. * Integration tests for argument parsing.
  306. * Documentation updates about repository encryption.
  307. 0.0.2
  308. * Configuration support for additional attic prune flags: keep_within, keep_hourly, keep_yearly,
  309. and prefix.
  310. 0.0.1
  311. * Initial release.