1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2024-12-23 08:16:54 +00:00
No description
Find a file
Jonas Borgström a5a73ca926 Fix reST syntax
[ci skip]
2013-07-08 21:57:25 +02:00
darc Remove hashing from PlaintextKey. 2013-07-08 14:00:22 +02:00
docs Update documentation 2013-07-08 21:19:50 +02:00
scripts setup.py: switch from setuptools to pure distutils 2012-02-29 23:30:24 +01:00
.gitignore Packaging improvements 2013-06-24 13:53:02 +02:00
.travis.yml Remove attempts to enable user_xattr 2013-07-04 11:58:48 +02:00
LICENSE Improved documentation. 2013-07-05 12:32:56 +02:00
MANIFEST.in Update documentation 2013-07-08 21:19:50 +02:00
README.rst Fix reST syntax 2013-07-08 21:57:25 +02:00
setup.py Improved documentation. 2013-07-05 12:32:56 +02:00
tox.ini Inline comments not supported in tox.ini 2013-07-05 12:36:49 +02:00

What is darc?
-------------
Darc is a Deduplicating ARChiver written in Python. The main goal of darc is
to provide an efficient and secure way to backup data. The data deduplication
technique used makes darc suitable for daily backups since only actual changes
are stored.

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

    $ darc init /usbdrive/my-backup.darc
    $ darc create -v /usbdrive/my-backup.darc::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
    darc can store data on any remote host accessible over SSH as long as
    darc is installed.

What do I need?
---------------
Darc requires Python 3.2 or above to work. Besides Python darc also requires 
msgpack-python and sufficiently recent OpenSSL (>= 1.0.0).

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

  $ pip install darc

Where are the docs?
-------------------
Go to https://pythonhosted.org/darc/ for a prebuilt version of the docs. You
can also build them yourself form the docs folder.

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

  $ python -m darc.testsuite.run

Contribute
----------
Found a bug? Have any ideas to improve darc? Add bug reports and feature
requests to the `issue tracker <https://github.com/jborg/darc/issues>`_.

You can also ask the author a question directly by
`email <mailto:jonas@borgstrom.se>`_.