mirrors/borgmatic: Simple, configuration-driven backup software for servers and workstations @ 0b1e38e5f64d6828cb6ffe7b57fb5e2cde3c6ae6

Simple, configuration-driven backup software for servers and workstations

Dan Helfman 0b1e38e5f6 Remove Python cache files before each Tox run.		6 年前
borgmatic	9417359da3 Fix for regression with missing verbose log entries (#177).	6 年前
docs	8f882ea3ea Switch to more standard "utm_source" for hosting provider link.	6 年前
sample	67f2862fb1 Change paths to reflect new pip install --user documentation.	6 年前
scripts	06261d8c86 Merge branch 'master' into tox-skip-missing-interpreters	6 年前
static	469feadbc0 Adding missing PNG logo.	7 年前
tests	1cf0e1bd84 Support for various Borg directory environment variables (#153).	6 年前
.drone.yml	60b1f9921d Don't use pip wrapper script in CI.	6 年前
.gitignore	d29c7956bc Upgrade ruamel.yaml compatibility version range and fix support for Python 3.7 (#38, #76).	7 年前
AUTHORS	52e4f48eb9 Add validate-borgmatic-config command	6 年前
LICENSE	7b3efddcbd Adding GPL v3 license.	10 年前
MANIFEST.in	4d7556f68b Basic YAML configuration file parsing.	8 年前
NEWS	9417359da3 Fix for regression with missing verbose log entries (#177).	6 年前
README.md	8f882ea3ea Switch to more standard "utm_source" for hosting provider link.	6 年前
pyproject.toml	20b8b45aeb Remove all configuration from Tox file	6 年前
setup.cfg	b94dbff216 Add isort configuration	6 年前
setup.py	9417359da3 Fix for regression with missing verbose log entries (#177).	6 年前
test_requirements.txt	b94dbff216 Add isort configuration	6 年前
tox.ini	85251cf5d4 Ensure to remove cache files for Tox runs	6 年前

title: borgmatic

permalink: borgmatic/index.html

Overview

borgmatic is a simple Python wrapper script for the Borg 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.

Here's an example config file:

location:
    # List of source directories to backup. Globs are expanded.
    source_directories:
        - /home
        - /etc
        - /var/log/syslog*

    # Paths to local or remote repositories.
    repositories:
        - user@backupserver:sourcehostname.borg

    # Any paths matching these patterns are excluded from backups.
    exclude_patterns:
        - /home/*/.cache

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

borgmatic is hosted at https://torsion.org/borgmatic with source code available. It's also mirrored on GitHub for convenience.

Want to see borgmatic in action? Check out the screencast.

How-to guides

Reference guides

Hosting providers

Need somewhere to store your encrypted offsite backups? The following hosting providers include specific support for Borg/borgmatic. Using these links and services helps support borgmatic development and hosting. (These are referral links, but without any tracking scripts or cookies.)

BorgBase: Borg hosting service with support for monitoring, 2FA, and append-only repos.

Support and contributing

Issues

You've got issues? Or an idea for a feature enhancement? We've got an issue tracker. In order to create a new issue or comment on an issue, you'll need to login first. Note that you can login with an existing GitHub account if you prefer.

Other questions or comments? Contact witten@torsion.org.

Contributing

If you'd like to contribute to borgmatic development, please feel free to submit a Pull Request or open an issue 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!

Also, please check out the borgmatic development how-to for info on cloning source code, running tests, etc.

README.md