borgmatic/README.md

97 lines
2.9 KiB
Markdown
Raw Normal View History

title: Atticmatic
date:
save_as: atticmatic/index.html
2014-11-27 18:29:31 +01:00
## Overview
2014-10-31 06:34:03 +01:00
atticmatic is a simple Python wrapper script for the [Attic backup
software](https://attic-backup.org/) that initiates a backup and prunes any
old backups according to a retention policy. 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 06:34:03 +01:00
Here's an example config file:
[location]
# Space-separated list of source directories to backup.
source_directories: /home /etc
# Path to local or remote Attic repository.
repository: user@backupserver:sourcehostname.attic
[retention]
# Retention policy for how many backups to keep in each category.
keep_daily: 7
keep_weekly: 4
keep_monthly: 6
Additionally, exclude patterns can be specified in a separate excludes config
file, one pattern per line.
atticmatic is hosted at <https://torsion.org/atticmatic> with [source code
available](https://torsion.org/hg/atticmatic). It's also mirrored on
[GitHub](https://github.com/witten/atticmatic) and
[BitBucket](https://bitbucket.org/dhelfman/atticmatic) for convenience.
2014-11-19 03:32:16 +01:00
2014-10-31 06:34:03 +01:00
2014-11-27 18:29:31 +01:00
## Setup
2014-10-31 06:34:03 +01:00
To get up and running with Attic, follow the [Attic Quick
Start](https://attic-backup.org/quickstart.html) guide to create an Attic
repository on a local or remote host. Note that if you plan to run atticmatic
on a schedule with cron, and you encrypt your attic repository with a
passphrase instead of a key file, you'll need to set the `ATTIC_PASSPHRASE`
environment variable. See [attic's repository encryption
documentation](https://attic-backup.org/quickstart.html#encrypted-repos) for
more info.
2014-10-31 06:34:03 +01:00
If the repository is on a remote host, make sure that your local root user has
key-based ssh access to the desired user account on the remote host.
To install atticmatic, run the following command to download and install it:
2014-10-31 06:34:03 +01:00
sudo pip install hg+https://torsion.org/hg/atticmatic
2014-10-31 06:34:03 +01:00
Then copy the following configuration files:
sudo cp sample/atticmatic.cron /etc/cron.d/atticmatic
sudo mkdir /etc/atticmatic/
2014-10-31 06:34:03 +01:00
sudo cp sample/config sample/excludes /etc/atticmatic/
Lastly, modify those files with your desired configuration.
2014-11-27 18:29:31 +01:00
## Usage
2014-10-31 06:34:03 +01:00
You can run atticmatic and start a backup simply by invoking it without
arguments:
atticmatic
This will also prune any old backups as per the configured retention policy.
By default, the backup will proceed silently except in the case of errors. But
if you'd like to to get additional information about the progress of the
backup as it proceeds, use the verbose option instead:
2014-10-31 06:34:03 +01:00
atticmattic --verbose
If you'd like to see the available command-line arguments, view the help:
atticmattic --help
2014-11-18 03:35:47 +01:00
2014-11-27 18:29:31 +01:00
## Running tests
2014-11-18 06:57:44 +01:00
To install test-specific dependencies, first run:
sudo python setup.py test
2014-11-18 06:57:44 +01:00
To actually run tests, run:
nosetests --detailed-errors
2014-11-27 18:29:31 +01:00
## Feedback
2014-11-18 03:35:47 +01:00
Questions? Comments? Got a patch? Contact <mailto:witten@torsion.org>.