2015-05-09 16:40:55 +00:00
|
|
|
|build|
|
|
|
|
|
|
|
|
What is Borg?
|
|
|
|
-------------
|
|
|
|
Borg is a deduplicating backup program. The main goal of Borg is to provide
|
2013-07-08 21:38:27 +00:00
|
|
|
an efficient and secure way to backup data. The data deduplication
|
2015-05-09 16:40:55 +00:00
|
|
|
technique used makes Borg suitable for daily backups since only changes
|
2013-07-05 10:32:56 +00:00
|
|
|
are stored.
|
|
|
|
|
2015-05-09 16:40:55 +00:00
|
|
|
Borg is a fork of Attic and maintained by "The Borg Collective" (see AUTHORS file).
|
|
|
|
|
2015-05-13 22:37:09 +00:00
|
|
|
BORG IS NOT COMPATIBLE WITH ORIGINAL ATTIC.
|
|
|
|
UNTIL FURTHER NOTICE, EXPECT THAT WE WILL BREAK COMPATIBILITY REPEATEDLY.
|
|
|
|
THIS IS SOFTWARE IN DEVELOPMENT, DECIDE YOURSELF IF IT FITS YOUR NEEDS.
|
|
|
|
|
|
|
|
Read issue #1 on the issue tracker, goals are being defined there.
|
|
|
|
|
|
|
|
Please also see the LICENSE for more informations.
|
|
|
|
|
2013-07-05 10:32:56 +00:00
|
|
|
Easy to use
|
|
|
|
~~~~~~~~~~~
|
2014-02-04 02:48:22 +00:00
|
|
|
Initialize backup repository and create a backup archive::
|
2013-07-05 10:32:56 +00:00
|
|
|
|
2015-05-09 17:41:03 +00:00
|
|
|
$ borg init /mnt/backup
|
|
|
|
$ borg create -v /mnt/backup::documents ~/Documents
|
2013-07-03 20:38:17 +00:00
|
|
|
|
|
|
|
Main features
|
2013-07-05 10:32:56 +00:00
|
|
|
~~~~~~~~~~~~~
|
2013-07-03 20:38:17 +00:00
|
|
|
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
|
2015-05-09 16:40:55 +00:00
|
|
|
Borg can store data on any remote host accessible over SSH. This is
|
|
|
|
most efficient if Borg is also installed on the remote host.
|
2013-07-03 20:38:17 +00:00
|
|
|
|
2013-08-05 18:54:27 +00:00
|
|
|
Backups mountable as filesystems
|
|
|
|
Backup archives are mountable as userspace filesystems for easy backup
|
|
|
|
verification and restores.
|
|
|
|
|
2013-07-03 20:38:17 +00:00
|
|
|
What do I need?
|
2013-07-05 10:32:56 +00:00
|
|
|
---------------
|
2015-05-09 16:40:55 +00:00
|
|
|
Borg requires Python 3.2 or above to work.
|
|
|
|
Borg also requires a sufficiently recent OpenSSL (>= 1.0.0).
|
2014-02-04 02:48:22 +00:00
|
|
|
In order to mount archives as filesystems, llfuse is required.
|
2010-10-27 18:40:48 +00:00
|
|
|
|
2013-07-03 20:38:17 +00:00
|
|
|
How do I install it?
|
2013-07-05 10:32:56 +00:00
|
|
|
--------------------
|
2013-07-03 20:38:17 +00:00
|
|
|
::
|
2013-07-08 19:57:25 +00:00
|
|
|
|
2015-05-09 16:40:55 +00:00
|
|
|
$ pip3 install borgbackup
|
2010-10-27 18:40:48 +00:00
|
|
|
|
2013-07-03 20:38:17 +00:00
|
|
|
Where are the docs?
|
2013-07-05 10:32:56 +00:00
|
|
|
-------------------
|
2015-05-09 16:40:55 +00:00
|
|
|
Go to https://borgbackup.github.io/ for a prebuilt version of the documentation.
|
2014-02-04 02:48:22 +00:00
|
|
|
You can also build it yourself from the docs folder.
|
2010-10-27 18:40:48 +00:00
|
|
|
|
2013-07-03 20:38:17 +00:00
|
|
|
Where are the tests?
|
2013-07-05 10:32:56 +00:00
|
|
|
--------------------
|
2015-05-09 16:40:55 +00:00
|
|
|
The tests are in the borg/testsuite package. To run the test suite use the
|
2013-07-03 20:38:17 +00:00
|
|
|
following command::
|
2011-11-06 16:28:32 +00:00
|
|
|
|
2015-05-09 16:40:55 +00:00
|
|
|
$ fakeroot -u tox # you need to have tox installed
|
|
|
|
|
|
|
|
.. |build| image:: https://travis-ci.org/borgbackup/borg.svg
|
|
|
|
:alt: Build Status
|
|
|
|
:target: https://travis-ci.org/borgbackup/borg
|