2018-09-02 05:45:13 +00:00
|
|
|
---
|
|
|
|
|
title: borgmatic
|
|
|
|
|
permalink: borgmatic/index.html
|
2018-09-02 05:38:17 +00:00
|
|
|
---
|
2014-11-27 17:29:31 +00:00
|
|
|
## Overview
|
2014-10-31 05:34:03 +00:00
|
|
|
|
2018-08-30 05:44:12 +00:00
|
|
|
<img src="https://projects.torsion.org/witten/borgmatic/raw/branch/master/static/borgmatic.png" width="150px" style="float: right; padding-left: 1em;">
|
|
|
|
|
|
2018-08-30 05:57:32 +00:00
|
|
|
borgmatic is a simple Python wrapper script for the
|
2018-09-03 05:06:57 +00:00
|
|
|
[Borg](https://www.borgbackup.org/) backup software that initiates a backup,
|
|
|
|
|
prunes any old backups according to a retention policy, and validates backups
|
|
|
|
|
for consistency. The script supports specifying your settings in a declarative
|
|
|
|
|
configuration file rather than having to put them all on the command-line, and
|
|
|
|
|
handles common errors.
|
2014-10-31 05:34:03 +00:00
|
|
|
|
2014-11-26 00:01:59 +00:00
|
|
|
Here's an example config file:
|
|
|
|
|
|
2017-07-05 01:23:59 +00:00
|
|
|
```yaml
|
|
|
|
|
location:
|
|
|
|
|
# List of source directories to backup. Globs are expanded.
|
|
|
|
|
source_directories:
|
|
|
|
|
- /home
|
|
|
|
|
- /etc
|
|
|
|
|
- /var/log/syslog*
|
|
|
|
|
|
2017-07-23 05:56:46 +00:00
|
|
|
# Paths to local or remote repositories.
|
|
|
|
|
repositories:
|
|
|
|
|
- user@backupserver:sourcehostname.borg
|
2017-07-05 01:23:59 +00:00
|
|
|
|
2017-07-10 18:06:28 +00:00
|
|
|
# Any paths matching these patterns are excluded from backups.
|
|
|
|
|
exclude_patterns:
|
|
|
|
|
- /home/*/.cache
|
|
|
|
|
|
2017-07-05 01:23:59 +00:00
|
|
|
retention:
|
|
|
|
|
# Retention policy for how many backups to keep in each category.
|
|
|
|
|
keep_daily: 7
|
|
|
|
|
keep_weekly: 4
|
|
|
|
|
keep_monthly: 6
|
|
|
|
|
|
|
|
|
|
consistency:
|
|
|
|
|
# List of consistency checks to run: "repository", "archives", or both.
|
|
|
|
|
checks:
|
|
|
|
|
- repository
|
|
|
|
|
- archives
|
2016-01-20 12:11:15 +00:00
|
|
|
```
|
2015-05-11 05:00:31 +00:00
|
|
|
|
2016-06-10 18:21:53 +00:00
|
|
|
borgmatic is hosted at <https://torsion.org/borgmatic> with [source code
|
2017-10-28 04:55:08 +00:00
|
|
|
available](https://projects.torsion.org/witten/borgmatic). It's also mirrored
|
2017-10-28 05:27:28 +00:00
|
|
|
on [GitHub](https://github.com/witten/borgmatic) for convenience.
|
2014-11-19 02:32:16 +00:00
|
|
|
|
2018-09-30 18:11:07 +00:00
|
|
|
Want to see borgmatic in action? Check out the <a
|
|
|
|
|
href="https://asciinema.org/a/203761" target="_blank">screencast</a>.
|
|
|
|
|
|
2018-09-30 04:38:38 +00:00
|
|
|
<script src="https://asciinema.org/a/203761.js" id="asciicast-203761" async></script>
|
2018-02-20 01:44:20 +00:00
|
|
|
|
2014-10-31 05:34:03 +00:00
|
|
|
|
2019-02-04 06:20:59 +00:00
|
|
|
## How-to guides
|
2014-10-31 05:34:03 +00:00
|
|
|
|
2019-02-04 06:20:59 +00:00
|
|
|
* [Set up backups with borgmatic](docs/how-to/set-up-backups.md) \<-- *Start here!*
|
|
|
|
|
* [Make per-application backups](docs/how-to/make-per-application-backups.md)
|
|
|
|
|
* [Deal with very large backups](docs/how-to/deal-with-very-large-backups.md)
|
|
|
|
|
* [Inspect your backups](docs/how-to/inspect-your-backups.md)
|
|
|
|
|
* [Run preparation steps before backups](docs/how-to/run-preparation-steps-before-backups.md)
|
|
|
|
|
* [Upgrade borgmatic](docs/how-to/upgrade.md)
|
|
|
|
|
* [Develop on borgmatic](docs/how-to/develop-on-borgmatic.md)
|
2016-06-10 18:53:45 +00:00
|
|
|
|
2017-07-10 18:06:28 +00:00
|
|
|
|
2018-06-17 21:55:57 +00:00
|
|
|
## Support and contributing
|
2014-11-18 05:57:44 +00:00
|
|
|
|
2018-06-17 21:55:57 +00:00
|
|
|
### Issues
|
|
|
|
|
|
|
|
|
|
You've got issues? Or an idea for a feature enhancement? We've got an [issue
|
|
|
|
|
tracker](https://projects.torsion.org/witten/borgmatic/issues). In order to
|
|
|
|
|
create a new issue or comment on an issue, you'll need to [login
|
|
|
|
|
first](https://projects.torsion.org/user/login). Note that you can login with
|
|
|
|
|
an existing GitHub account if you prefer.
|
|
|
|
|
|
|
|
|
|
Other questions or comments? Contact <mailto:witten@torsion.org>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Contributing
|
|
|
|
|
|
|
|
|
|
If you'd like to contribute to borgmatic development, please feel free to
|
|
|
|
|
submit a [Pull Request](https://projects.torsion.org/witten/borgmatic/pulls)
|
|
|
|
|
or open an [issue](https://projects.torsion.org/witten/borgmatic/issues) first
|
|
|
|
|
to discuss your idea. We also accept Pull Requests on GitHub, if that's more
|
|
|
|
|
your thing. In general, contributions are very welcome. We don't bite!
|
|
|
|
|
|
2019-02-04 06:20:59 +00:00
|
|
|
Also, please check out the [borgmatic development
|
|
|
|
|
how-to](docs/how-to/develop-on-borgmatic.md) for info on cloning source code,
|
|
|
|
|
running tests, etc.
|
