Releases

Latest development release

Version: 1.40
Released: 2024-08-05
  • 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.

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

1.40 (2024-08-05)

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)

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)

1.32 (2022-04-01)

1.31 (2022-03-21)

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)

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)

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)

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)

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)

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)

1.6 (2019-10-04)

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)

1.3 (2019-01-16)

  • Added the raw borg command.

1.2 (2019-01-16)

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)

0.3 (2018-12-25)

  • Initial public release (beta).

0.0 (2018-12-05)

  • Initial release (alpha).