2017-09-07 17:15:53 +00:00
|
|
|
|screencast_basic|
|
2015-10-24 21:58:05 +00:00
|
|
|
|
2017-09-07 17:15:53 +00:00
|
|
|
More screencasts: `installation`_, `advanced usage`_
|
2016-07-11 21:16:53 +00:00
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
What is BorgBackup?
|
2016-11-03 17:54:07 +00:00
|
|
|
-------------------
|
2016-01-15 18:06:20 +00:00
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
BorgBackup (short: Borg) is a deduplicating backup program.
|
|
|
|
Optionally, it supports compression and authenticated encryption.
|
2015-05-13 22:37:09 +00:00
|
|
|
|
2015-08-06 10:59:51 +00:00
|
|
|
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.
|
|
|
|
The authenticated encryption technique makes it suitable for backups to not
|
|
|
|
fully trusted targets.
|
2015-07-27 12:45:32 +00:00
|
|
|
|
2015-10-07 22:33:43 +00:00
|
|
|
See the `installation manual`_ or, if you have already
|
2015-10-07 21:36:34 +00:00
|
|
|
downloaded Borg, ``docs/installation.rst`` to get started with Borg.
|
2018-11-28 02:05:46 +00:00
|
|
|
There is also an `offline documentation`_ available, in multiple formats.
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2015-11-15 00:13:25 +00:00
|
|
|
.. _installation manual: https://borgbackup.readthedocs.org/en/stable/installation.html
|
2018-01-30 15:29:31 +00:00
|
|
|
.. _offline documentation: https://readthedocs.org/projects/borgbackup/downloads
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2013-07-03 20:38:17 +00:00
|
|
|
Main features
|
2016-11-03 17:54:07 +00:00
|
|
|
~~~~~~~~~~~~~
|
2016-02-27 16:22:56 +00:00
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
**Space efficient storage**
|
|
|
|
Deduplication based on content-defined chunking is used to reduce the number
|
|
|
|
of bytes stored: each file is split into a number of variable length chunks
|
|
|
|
and only chunks that have never been seen before are added to the repository.
|
|
|
|
|
2017-04-25 21:38:55 +00:00
|
|
|
A chunk is considered duplicate if its id_hash value is identical.
|
|
|
|
A cryptographically strong hash or MAC function is used as id_hash, e.g.
|
|
|
|
(hmac-)sha256.
|
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
To deduplicate, all the chunks in the same repository are considered, no
|
|
|
|
matter whether they come from different machines, from previous backups,
|
|
|
|
from the same backup or even from the same single file.
|
|
|
|
|
|
|
|
Compared to other deduplication approaches, this method does NOT depend on:
|
|
|
|
|
2016-07-27 13:12:52 +00:00
|
|
|
* file/directory names staying the same: So you can move your stuff around
|
2016-01-18 15:30:27 +00:00
|
|
|
without killing the deduplication, even between machines sharing a repo.
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2016-07-27 13:12:52 +00:00
|
|
|
* complete files or time stamps staying the same: If a big file changes a
|
|
|
|
little, only a few new chunks need to be stored - this is great for VMs or
|
2016-01-18 15:30:27 +00:00
|
|
|
raw disks.
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2016-07-27 13:12:52 +00:00
|
|
|
* The absolute position of a data chunk inside a file: Stuff may get shifted
|
2016-01-18 15:30:27 +00:00
|
|
|
and will still be found by the deduplication algorithm.
|
2015-08-06 14:39:50 +00:00
|
|
|
|
|
|
|
**Speed**
|
2020-03-20 09:57:31 +00:00
|
|
|
* performance-critical code (chunking, compression, encryption) is
|
2015-08-06 14:39:50 +00:00
|
|
|
implemented in C/Cython
|
|
|
|
* local caching of files/chunks index data
|
|
|
|
* quick detection of unmodified files
|
|
|
|
|
|
|
|
**Data encryption**
|
|
|
|
All data can be protected using 256-bit AES encryption, data integrity and
|
2015-12-03 16:35:52 +00:00
|
|
|
authenticity is verified using HMAC-SHA256. Data is encrypted clientside.
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2020-11-16 21:51:55 +00:00
|
|
|
**Obfuscation**
|
|
|
|
Optionally, borg can actively obfuscate e.g. the size of files / chunks to
|
|
|
|
make fingerprinting attacks more difficult.
|
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
**Compression**
|
2017-12-18 21:53:24 +00:00
|
|
|
All data can be optionally compressed:
|
|
|
|
|
|
|
|
* lz4 (super fast, low compression)
|
|
|
|
* zstd (wide range from high speed and low compression to high compression
|
|
|
|
and lower speed)
|
|
|
|
* zlib (medium speed and compression)
|
|
|
|
* lzma (low speed, high compression)
|
2015-08-06 14:39:50 +00:00
|
|
|
|
|
|
|
**Off-site backups**
|
|
|
|
Borg can store data on any remote host accessible over SSH. If Borg is
|
|
|
|
installed on the remote host, big performance gains can be achieved
|
|
|
|
compared to using a network filesystem (sshfs, nfs, ...).
|
|
|
|
|
|
|
|
**Backups mountable as filesystems**
|
|
|
|
Backup archives are mountable as userspace filesystems for easy interactive
|
|
|
|
backup examination and restores (e.g. by using a regular file manager).
|
|
|
|
|
2015-10-07 22:15:30 +00:00
|
|
|
**Easy installation on multiple platforms**
|
2015-12-20 15:38:38 +00:00
|
|
|
We offer single-file binaries that do not require installing anything -
|
|
|
|
you can just run them on these platforms:
|
2015-10-07 22:15:30 +00:00
|
|
|
|
|
|
|
* Linux
|
|
|
|
* Mac OS X
|
|
|
|
* FreeBSD
|
2015-10-07 22:37:35 +00:00
|
|
|
* OpenBSD and NetBSD (no xattrs/ACLs support or binaries yet)
|
2017-11-05 18:24:49 +00:00
|
|
|
* Cygwin (experimental, no binaries yet)
|
|
|
|
* Linux Subsystem of Windows 10 (experimental)
|
2015-08-06 10:59:51 +00:00
|
|
|
|
2015-08-06 14:39:50 +00:00
|
|
|
**Free and Open Source Software**
|
|
|
|
* security and functionality can be audited independently
|
2016-11-03 18:03:48 +00:00
|
|
|
* licensed under the BSD (3-clause) license, see `License`_ for the
|
|
|
|
complete license
|
2015-08-06 10:59:51 +00:00
|
|
|
|
|
|
|
Easy to use
|
2016-11-03 17:54:07 +00:00
|
|
|
~~~~~~~~~~~
|
2016-02-27 16:22:56 +00:00
|
|
|
|
2017-10-12 14:14:32 +00:00
|
|
|
Initialize a new backup repository (see ``borg init --help`` for encryption options)::
|
|
|
|
|
|
|
|
$ borg init -e repokey /path/to/repo
|
|
|
|
|
|
|
|
Create a backup archive::
|
2015-08-06 10:59:51 +00:00
|
|
|
|
2016-04-15 01:35:37 +00:00
|
|
|
$ borg create /path/to/repo::Saturday1 ~/Documents
|
2015-08-06 10:59:51 +00:00
|
|
|
|
2016-11-27 19:16:41 +00:00
|
|
|
Now doing another backup, just to show off the great deduplication::
|
2015-08-06 10:59:51 +00:00
|
|
|
|
2016-04-15 01:35:37 +00:00
|
|
|
$ borg create -v --stats /path/to/repo::Saturday2 ~/Documents
|
2016-02-27 16:22:56 +00:00
|
|
|
-----------------------------------------------------------------------------
|
|
|
|
Archive name: Saturday2
|
|
|
|
Archive fingerprint: 622b7c53c...
|
|
|
|
Time (start): Sat, 2016-02-27 14:48:13
|
|
|
|
Time (end): Sat, 2016-02-27 14:48:14
|
|
|
|
Duration: 0.88 seconds
|
|
|
|
Number of files: 163
|
|
|
|
-----------------------------------------------------------------------------
|
|
|
|
Original size Compressed size Deduplicated size
|
|
|
|
This archive: 6.85 MB 6.85 MB 30.79 kB <-- !
|
|
|
|
All archives: 13.69 MB 13.71 MB 6.88 MB
|
|
|
|
|
|
|
|
Unique chunks Total chunks
|
|
|
|
Chunk index: 167 330
|
|
|
|
-----------------------------------------------------------------------------
|
2015-08-06 10:59:51 +00:00
|
|
|
|
|
|
|
|
2016-04-29 01:19:27 +00:00
|
|
|
For a graphical frontend refer to our complementary project `BorgWeb <https://borgweb.readthedocs.io/>`_.
|
2015-08-06 10:59:51 +00:00
|
|
|
|
2019-04-27 13:57:28 +00:00
|
|
|
Helping, Donations and Bounties, becoming a Patron
|
|
|
|
--------------------------------------------------
|
2017-05-22 16:22:09 +00:00
|
|
|
|
|
|
|
Your help is always welcome!
|
2019-04-27 13:57:28 +00:00
|
|
|
|
2017-05-22 16:22:09 +00:00
|
|
|
Spread the word, give feedback, help with documentation, testing or development.
|
|
|
|
|
|
|
|
You can also give monetary support to the project, see there for details:
|
|
|
|
|
2019-04-27 13:57:28 +00:00
|
|
|
https://www.borgbackup.org/support/fund.html
|
2017-05-22 16:22:09 +00:00
|
|
|
|
2015-10-13 03:27:59 +00:00
|
|
|
Links
|
2016-11-03 17:54:07 +00:00
|
|
|
-----
|
2015-10-13 03:27:59 +00:00
|
|
|
|
2016-01-18 15:30:27 +00:00
|
|
|
* `Main Web Site <https://borgbackup.readthedocs.org/>`_
|
2016-07-04 20:37:24 +00:00
|
|
|
* `Releases <https://github.com/borgbackup/borg/releases>`_,
|
|
|
|
`PyPI packages <https://pypi.python.org/pypi/borgbackup>`_ and
|
|
|
|
`ChangeLog <https://github.com/borgbackup/borg/blob/master/docs/changes.rst>`_
|
2018-01-30 15:29:31 +00:00
|
|
|
* `Offline Documentation <https://readthedocs.org/projects/borgbackup/downloads>`_
|
2017-05-22 16:22:09 +00:00
|
|
|
* `GitHub <https://github.com/borgbackup/borg>`_ and
|
|
|
|
`Issue Tracker <https://github.com/borgbackup/borg/issues>`_.
|
2016-07-04 20:37:24 +00:00
|
|
|
* `Web-Chat (IRC) <http://webchat.freenode.net/?randomnick=1&channels=%23borgbackup&uio=MTY9dHJ1ZSY5PXRydWUa8>`_ and
|
|
|
|
`Mailing List <https://mail.python.org/mailman/listinfo/borgbackup>`_
|
2016-01-25 12:33:48 +00:00
|
|
|
* `License <https://borgbackup.readthedocs.org/en/stable/authors.html#license>`_
|
2016-12-22 14:21:42 +00:00
|
|
|
* `Security contact <https://borgbackup.readthedocs.io/en/latest/support.html#security-contact>`_
|
2015-10-13 03:27:59 +00:00
|
|
|
|
2016-11-03 18:03:48 +00:00
|
|
|
Compatibility notes
|
2016-11-03 17:54:07 +00:00
|
|
|
-------------------
|
2015-08-06 14:39:50 +00:00
|
|
|
|
2015-08-06 10:59:51 +00:00
|
|
|
EXPECT THAT WE WILL BREAK COMPATIBILITY REPEATEDLY WHEN MAJOR RELEASE NUMBER
|
2016-02-27 16:22:56 +00:00
|
|
|
CHANGES (like when going from 0.x.y to 1.0.0 or from 1.x.y to 2.0.0).
|
2015-10-07 22:33:43 +00:00
|
|
|
|
2015-08-06 10:59:51 +00:00
|
|
|
NOT RELEASED DEVELOPMENT VERSIONS HAVE UNKNOWN COMPATIBILITY PROPERTIES.
|
|
|
|
|
|
|
|
THIS IS SOFTWARE IN DEVELOPMENT, DECIDE YOURSELF WHETHER IT FITS YOUR NEEDS.
|
2010-10-27 18:40:48 +00:00
|
|
|
|
2016-11-04 15:26:02 +00:00
|
|
|
Security issues should be reported to the `Security contact`_ (or
|
2020-03-20 09:57:31 +00:00
|
|
|
see ``docs/support.rst`` in the source distribution).
|
2016-11-04 14:31:27 +00:00
|
|
|
|
2016-11-23 01:01:26 +00:00
|
|
|
.. start-badges
|
|
|
|
|
2017-06-03 12:40:08 +00:00
|
|
|
|doc| |build| |coverage| |bestpractices| |bounties|
|
|
|
|
|
|
|
|
.. |bounties| image:: https://api.bountysource.com/badge/team?team_id=78284&style=bounties_posted
|
|
|
|
:alt: Bounty Source
|
|
|
|
:target: https://www.bountysource.com/teams/borgbackup
|
2016-01-15 18:06:20 +00:00
|
|
|
|
|
|
|
.. |doc| image:: https://readthedocs.org/projects/borgbackup/badge/?version=stable
|
|
|
|
:alt: Documentation
|
2016-01-17 21:31:08 +00:00
|
|
|
:target: https://borgbackup.readthedocs.org/en/stable/
|
2015-05-09 16:40:55 +00:00
|
|
|
|
2020-11-02 22:04:38 +00:00
|
|
|
.. |build| image:: https://travis-ci.com/borgbackup/borg.svg?branch=master
|
|
|
|
:alt: Build Status (master)
|
|
|
|
:target: https://travis-ci.com/borgbackup/borg
|
2015-08-08 00:34:42 +00:00
|
|
|
|
2015-12-07 02:08:32 +00:00
|
|
|
.. |coverage| image:: https://codecov.io/github/borgbackup/borg/coverage.svg?branch=master
|
2015-08-08 00:34:42 +00:00
|
|
|
:alt: Test Coverage
|
2015-12-07 02:08:32 +00:00
|
|
|
:target: https://codecov.io/github/borgbackup/borg?branch=master
|
2016-01-15 18:06:20 +00:00
|
|
|
|
2017-09-07 17:15:53 +00:00
|
|
|
.. |screencast_basic| image:: https://asciinema.org/a/133292.png
|
|
|
|
:alt: BorgBackup Basic Usage
|
|
|
|
:target: https://asciinema.org/a/133292?autoplay=1&speed=1
|
2020-03-14 19:06:09 +00:00
|
|
|
:width: 100%
|
2017-09-07 17:15:53 +00:00
|
|
|
|
|
|
|
.. _installation: https://asciinema.org/a/133291?autoplay=1&speed=1
|
|
|
|
|
|
|
|
.. _advanced usage: https://asciinema.org/a/133293?autoplay=1&speed=1
|
2016-09-03 19:11:47 +00:00
|
|
|
|
|
|
|
.. |bestpractices| image:: https://bestpractices.coreinfrastructure.org/projects/271/badge
|
|
|
|
:alt: Best Practices Score
|
|
|
|
:target: https://bestpractices.coreinfrastructure.org/projects/271
|
2016-11-23 01:01:26 +00:00
|
|
|
|
|
|
|
.. end-badges
|