Releases

Latest development release

Version: 1.38.1

Released: 2023-11-08

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).