mirror
/
borg
mirror of https://github.com/borgbackup/borg.git
1
0
Fork 0
Code Issues Releases Wiki Activity
735 Commits 9 Branches 132 Tags 68 MiB
Python 82.8%
Cython 8.1%
C 4%
HTML 3.3%
Shell 1.8%
Go to file
Thomas Waldmann 247677dd3d updated CHANGES-borg.txt 2015-05-13 18:51:01 +02:00
attic rename cli level test method 2015-05-13 15:15:08 +02:00
docs get rid of some .borg, be consistent with the backup repo name and path 2015-05-13 15:02:33 +02:00
scripts fork: s/attic/borg/g, fix URLs, add new section to AUTHORS 2015-05-13 15:02:33 +02:00
.gitattributes Added .gitattributes 2013-08-12 15:12:14 +02:00
.gitignore PR #206 - Merge branch 'fixes' of https://github.com/thomaswaldmann/attic into merge 2015-03-06 23:18:08 +01:00
.travis.yml travis: Enable python 3.4 2014-05-01 14:08:12 +02:00
AUTHORS fork: s/attic/borg/g, fix URLs, add new section to AUTHORS 2015-05-13 15:02:33 +02:00
CHANGES Fix typo preventing the security confirmation prompt from working 2015-05-08 17:41:50 +02:00
CHANGES-borg.txt updated CHANGES-borg.txt 2015-05-13 18:51:01 +02:00
LICENSE fork: s/attic/borg/g, fix URLs, add new section to AUTHORS 2015-05-13 15:02:33 +02:00
MANIFEST.in Include missing pyx files in dist file. 2015-01-04 22:25:11 +01:00
README.rst get rid of some .borg, be consistent with the backup repo name and path 2015-05-13 15:02:33 +02:00
setup.py fork: s/attic/borg/g, fix URLs, add new section to AUTHORS 2015-05-13 15:02:33 +02:00
tox.ini Add python 3.4 to the tox environment list 2014-05-03 14:21:10 +02:00
versioneer.py Start using versioneer for version numbers 2013-08-05 23:05:15 +02:00

README.rst 

|build|

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

Borg is a fork of Attic and maintained by "The Borg Collective" (see AUTHORS file).

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

    $ borg init /mnt/backup
    $ borg create -v /mnt/backup::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
    Borg can store data on any remote host accessible over SSH.  This is
    most efficient if Borg 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?
---------------
Borg requires Python 3.2 or above to work.
Borg also requires a sufficiently recent OpenSSL (>= 1.0.0).
In order to mount archives as filesystems, llfuse is required.

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

  $ pip3 install borgbackup

Where are the docs?
-------------------
Go to https://borgbackup.github.io/ 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 borg/testsuite package. To run the test suite use the
following command::

  $ 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