Releases

Latest development release

Version: 1.41

Released: 2024-11-11

1.41 (2024-11-11)

• When Emborg encounters an error when operating on a composite configuration it terminates the problematic configuration and moves to the next. Previously it would exit without attempting the remaining configs.

• emborg-overdue can now run an emborg-overdue process on a remote host and include the results in its report.

• message templates for emborg-overdue can now contain the locked field.

• Allow location of config and data directory to be overridden with XDG_CONFIG_HOME and XDG_DATA_HOME environment variables. This replaces an earlier behavior that simply treated ~/.config/ as the configuration directory if it exists. No provision was made previously to support an alternative data directory.

Note

If your configuration files are in ~/.config/emborg and you are not on a Linux system you will now have to set XDG_CONFIG_HOME to $HOME/.config.

1.40 (2024-08-05)

• Enhance emborg-overdue command.

• Fix bug in restore when there are multiple roots.

1.39 (2024-04-29)

• Add date of last check to output of info command.

• Added cmd_name setting.

• Miscellaneous refinements.

1.38 (2023-11-04)

• Added ‘last checked date’ reporting to due command.

• Do not run check –repair and compact commands if –dry-run is requested.

• Pass output of Borg create command to hooks to allow it to be reported to healthchecks.io.

1.37 (2023-05-18)

• Add missing dependency.

1.36 (2023-05-15)

This release provides new mechanisms that allow you to monitor your pruning and compaction operations to help assure that these activities are not neglected. Both a prune and a compact operation must be performed to release disk space by eliminating expired archives. The combination of these to operations is referred to by Emborg as a squeeze.

• specifying an integer for --date now finds archive by index.

• due and info commands now report the latest prune and compact operations as well as the latest create operation.

Note

If you use emborg-overdue from the client you will need to change the paths you specify in overdue.conf. They now need to end in .latest.nt rather than .lastbackup.

Note

If you use Borg-Space, you will need to upgrade to version 2.

1.35 (2023-03-20)

• Improved the time resolution in due command.

• Added si format to manifest command.

• Allow config_dir to be specified through API.

1.34 (2022-11-03)

• Added ability to apply the info command to a particular archive.

1.33 (2022-10-22)

• Added compare command.

• Added manage_diffs_cmd and report_diffs_cmd settings.

• Allow ~/.config/emborg to always hold settings files if user prefers.

1.32 (2022-04-01)

• Fixed issues associated with compact_after_delete setting.

1.31 (2022-03-21)

• Enhanced Emborg to support new Borg 1.2 features.

  • Added compact command

  • Added compact_after_delete, chunker_params, sparse, threshold, upload_ratelimit, upload_buffer settings.

• Added the run_before_borg and run_after_borg settings.

• Added the --cache-only option and the ability to delete multiple archives at one time to the delete command.

1.30 (2022-01-04)

• Fix some issues with relative paths.

1.29 (2021-12-18)

• Do not signal failure to hooks if Borg completes normally, even if there were warnings.

• Return an exit status of 1 if Emborg runs to completion but with exceptions, and 2 if it cannot complete normally due to a error or errors.

1.28 (2021-11-06)

• Suppress log file generation for configs, due, help, log, settings and version commands.

• Add version to the API.

1.27 (2021-09-21)

• Improve the logging for composite configurations.

• Add support for Borg-Space, a utility that allows you to track and plot disk space usage for your Borg repositories over time.

1.26 (2021-09-03)

• Improve the tests.

• Allow access to names of child configs through API.

1.25 (2021-08-28)

• Added the compare command.

• Added the manage_diffs_cmd and report_diffs_cmd settings.

• Added the run_before_first_backup and run_after_last_backup settings.

• Allow files listed by manifest command to be constrained to those contained within a path.

• Allow relative dates to be specified on the extract, manifest, mount and restore commands.

• Allow BORG_PASSPHRASE, BORG_PASSPHRASE_FD, or BORG_PASSCOMMAND to dominate over Emborg passphrase settings.

1.24 (2021-07-05)

• Added healthchecks_url and cronhub_url settings.

1.23 (2021-07-01)

• Fix missing dependency.

1.22 (2021-06-21)

• Added support for healthchecks.io monitoring service.

• Added support for cronhub.io monitoring service.

1.21 (2021-03-11)

• Made extensive changes to manifest command to make it more flexible

  • colorized the output based on file health (green implies healthy, red implies unhealthy)

  • added --no-color option to manifest to suppress colorization

  • added colorscheme setting.

  • added manifest_default_format setting.

  • added support for Borg list command field names for both reporting and sorting.

  • added Emborg variants to some of the Borg field names.

  • added --show-formats command line option.

  • added --format command line option.

  • added --sort-by-field command line option.

  • change predefined formats to use fields that render faster

  Warning

  These changes are not backward compatible. If you have a manifest_formats setting from a previous version, it may need to be updated.

• It is now an error for prefix setting to contain {{now}}.

• Settings command will now print a single setting value if its name is given.

1.20 (2021-02-13)

• Add --progress command-line option and show_progress option to the create command.

1.19 (2021-01-02)

• Added --list command-line option to the prune command.

1.18 (2020-07-19)

• Added --repo option to delete command.

• Added --relocated global command-line option.

• Emborg now automatically confirms to Borg that you know what you are doing when you delete a repository or repair an archive.

1.17 (2020-04-15)

• Borg command allows archive to be added to @repo.

• Added encoding setting.

1.16 (2020-03-17)

• Refinements and bug fixes.

1.15 (2020-03-06)

• Improve messaging from emborg-overdue

• Configs command now outputs default configuration too.

• Some commands now use first subconfig when run with a composite configuration rather than terminating with an error.

• Added show_stats setting.

• Added --stats option to create, delete and prune commands.

• Added --list option to create, extract and restore commands.

• Added sorting and formatting options to manifest command.

• Added manifest_formats setting.

• Renamed --trial-run option to --dry-run to be more consistent with Borg.

• Add files and f aliases to manifest command.

• Added working_dir setting.

• Added do_not_expand setting.

• Added exclude_nodump setting

• Added patterns and patterns_from settings.

• Emborg lock file is now ignored if the process it references is no longer running

• Support --repair option on check command.

1.14 (2019-12-31)

• Remove debug message accidentally left in emborg-overdue

1.13 (2019-12-31)

• Enhance emborg-overdue to work on clients as well as servers

1.12 (2019-12-25)

• Added default_mount_point setting.

• Fixed some issues with borg command.

• Added --oldest option to due command.

1.11 (2019-11-27)

• Bug fix release.

1.10 (2019-11-11)

• Bug fix release.

1.9 (2019-11-08)

• Added ability to check individual archives to the check command.

• Made latest archive the default for check command.

• Allow exclude_from setting to be a list of file names.

1.8 (2019-10-12)

• Remove duplicated commands.

1.7 (2019-10-07)

• Fixed bug that involved the Boolean Borg settings (one_file_system, exclude_caches, …)

1.6 (2019-10-04)

• Added restore command.

• Added verbose setting.

1.5 (2019-09-30)

• Added composite configurations.

• Added support for multiple backup configurations in a single repository.

• Added prefix and exclude_from settings.

• Provide default value for archive setting.

• Add --all command line option to mount command.

• Add --include-external command line option to check, list, mount, and prune commands.

• Add --sort command line option to manifest command.

• Add --latest command line option to delete command.

• Added --quiet command line option

• umount command now deletes directory used as mount point.

• Moved log files to ~/.local/share/emborg (run ‘mv ~/.config/emborg/*.{log,lastbackup}* ~/.local/share/emborg’ before using this version).

1.4 (2019-04-24)

• Added ssh_command setting

• Added --fast option to info command

• Added emborg-overdue executable

• Allow run_before_backup and run_after_backup to be simple strings

1.3 (2019-01-16)

• Added the raw borg command.

1.2 (2019-01-16)

• Added the borg_executable and passcommand settings.

1.1 (2019-01-13)

• Improved and documented API.

• Creates the settings directory if it is missing and add example files.

• Added --mute command line option.

• Support multiple email addresses in notify.

• Added warning if settings file is world readable and contains a passphrase.

1.0 (2019-01-09)

• Added remote_path setting.

• Formal public release.

0.3 (2018-12-25)

• Initial public release (beta).

0.0 (2018-12-05)

• Initial release (alpha).