Deduplicating archiver with compression and authenticated encryption.

Thomas Waldmann fbaa505191 PR #206 - Merge branch 'fixes' of https://github.com/thomaswaldmann/attic into merge 10 years ago
attic fbaa505191 PR #206 - Merge branch 'fixes' of https://github.com/thomaswaldmann/attic into merge 10 years ago
docs 2fbef266f9 PR #156 - Merge branch 'doc-multi' of https://github.com/anarcat/attic into merge 10 years ago
scripts b718a443a8 Project rename 12 years ago
.gitattributes 3a9425f678 Added .gitattributes 11 years ago
.gitignore fbaa505191 PR #206 - Merge branch 'fixes' of https://github.com/thomaswaldmann/attic into merge 10 years ago
.travis.yml c90c6c9e9d travis: Enable python 3.4 11 years ago
AUTHORS 0b4e324af2 chunker: optimized the barrel shift 11 years ago
CHANGES 4ab4ecc7af hashindex: Fix issue with file sizes larger than 2GB. 10 years ago
LICENSE 3a064aba56 Fix sorting of segment names to ignore NFS left over files. 11 years ago
MANIFEST.in df6324b725 Include missing pyx files in dist file. 10 years ago
README.rst 10ef7fe0f2 Move website to attic-backup.org 11 years ago
setup.py 0741aef880 Add MacPorts' path to the default openssl search path 10 years ago
tox.ini db0381e6f2 Add python 3.4 to the tox environment list 11 years ago
versioneer.py 3b4875cf2e Start using versioneer for version numbers 12 years ago

README.rst

What is Attic?
--------------
Attic is a deduplicating backup program. The main goal of Attic is to provide
an efficient and secure way to backup data. The data deduplication
technique used makes Attic suitable for daily backups since only changes
are stored.

Easy to use
~~~~~~~~~~~
Initialize backup repository and create a backup archive::

$ attic init /usbdrive/my-backup.attic
$ attic create -v /usbdrive/my-backup.attic::documents ~/Documents

Main features
~~~~~~~~~~~~~
Space efficient storage
Variable block size deduplication is used to reduce the number of bytes
stored by detecting redundant data. Each file is split into a number of
variable length chunks and only chunks that have never been seen before are
compressed and added to the repository.

Optional data encryption
All data can be protected using 256-bit AES encryption and data integrity
and authenticity is verified using HMAC-SHA256.

Off-site backups
Attic can store data on any remote host accessible over SSH. This is
most efficient if Attic is also installed on the remote host.

Backups mountable as filesystems
Backup archives are mountable as userspace filesystems for easy backup
verification and restores.

What do I need?
---------------
Attic requires Python 3.2 or above to work. Besides Python, Attic also requires
msgpack-python and sufficiently recent OpenSSL (>= 1.0.0).
In order to mount archives as filesystems, llfuse is required.

How do I install it?
--------------------
::

$ pip install Attic

Where are the docs?
-------------------
Go to https://attic-backup.org/ for a prebuilt version of the documentation.
You can also build it yourself from the docs folder.

Where are the tests?
--------------------
The tests are in the attic/testsuite package. To run the test suite use the
following command::

$ fakeroot -u python -m attic.testsuite.run