App::BorgRestore::Settings(3pm) User Contributed Perl Documentation App::BorgRestore::Settings(3pm)

App::BorgRestore::Settings - Settings package

App::BorgRestore::Settings searches for configuration files in the following locations in order. The first file found will be used, any later ones are ignored. If no files are found, defaults are used.

  • $XDG_CONFIG_HOME/borg-restore.cfg
  • /etc/borg-restore.cfg

You can set the following options in the config file.

Note that the configuration file is parsed as a perl script. Thus you can also use any features available in perl itself.

Also note that it is important that the last statement of the file is positive because it is used to check that running the config went well. You can simply use "1;" on the last line as shown in the example config.

This specifies the URL to the borg repo as used in other borg commands. If you use the $BORG_REPO environment variable set this to an empty string. Default: "backup:borg-".hostname;
This specifies that only archives with the prefix should be considered. For example, if you back up multiple things (file system and database) into differntly named archives (fs-* and db-*), this can be used to only consider file system archives to keep the database size small. In the example you'd set the setting to "fs-". An empty string considers all archives. Default: ""
This defaults to "$XDG_CACHE_HOME/". It contains the lookup database.
This is an array of prefixes that need to be added or removed when looking up a file in the backup archives. If you use filesystem snapshots and the snapshot for /home is located at /mnt/snapshots/home, you have to add the following:

# In the backup archives, /home has the path /mnt/snapshots/home {regex => "^/home/", replacement => "mnt/snapshots/home/"},

The regex must always include the leading slash and it is suggested to include a tailing slash as well to prevent clashes with directories that start with the same string. The first regex that matches for a given file is used. This setting only affects lookups, it does not affect the creation of the database with --update-database.

If you create a backup of /home/user only, you will need to use the following:

# In the backup archives, /home/user/foo has the path foo {regex => "^/home/user", replacement => ""},

Default: 102400

The size of the in-memory cache of sqlite in kibibytes. Increasing this may reduce disk IO and improve performance on certain systems when updating the cache.

Default: 0

When new archives are added to the cache, the modification time of each parent directory for a file's path are updated. If this setting is set to 1, these updates are done in memory before data is written to the database. If it is set to 0, any changes are written directly to the database. Many values are updated multiple time, thus writing directly to the database is slower, but preparing the data in memory may require a substaintial amount of memory.

New in version 3.2.0. Deprecated in v3.2.0 for future removal possibly in v4.0.0.

$borg_repo = "/path/to/repo";
$backup_prefix = "";
$cache_path_base = "/mnt/somewhere/";
@backup_prefixes = (
       {regex => "^/home/", replacement => "mnt/snapshots/home/"},
       # /boot is not snapshotted
       {regex => "^/boot/", replacement => "boot"},
       {regex => "^/", replacement => "mnt/snapshots/root/"},
$sqlite_cache_size = 2097152;
$prepare_data_in_memory = 0;
1; #ensure positive return value

Copyright (C) 2016-2018 Florian Pritz <>

Licensed under the GNU General Public License version 3 or later. See LICENSE for the full license text.

2023-09-03 perl v5.38.0