mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-23 00:07:38 +00:00
9ead4097cf
it seems like there is currently no bureaucracy required, freenode web site says group registration is suspended. i also asked on the freenode channel, they said just make sure you are right here and use it. so we do that now.
81 lines
2.6 KiB
ReStructuredText
81 lines
2.6 KiB
ReStructuredText
.. include:: global.rst.inc
|
|
|
|
Welcome to Borg
|
|
================
|
|
|project_name| is a deduplicating and compressing backup program.
|
|
Optionally, it also supports authenticated encryption.
|
|
|
|
The main goal of |project_name| is to provide an efficient and secure way
|
|
to backup data. The data deduplication technique used makes |project_name|
|
|
suitable for daily backups since only the changes are stored. The authenticated
|
|
encryption makes it suitable for backups to not fully trusted targets.
|
|
|
|
|project_name| is written in Python (with a little bit of Cython and C for
|
|
the performance critical parts).
|
|
|
|
|
|
Easy to use
|
|
-----------
|
|
Initialize a new backup :ref:`repository <repository_def>` and create your
|
|
first backup :ref:`archive <archive_def>` in two lines::
|
|
|
|
$ borg init /mnt/backup
|
|
$ borg create /mnt/backup::Monday ~/Documents
|
|
$ borg create --stats /mnt/backup::Tuesday ~/Documents
|
|
Archive name: Tuesday
|
|
Archive fingerprint: 387a5e3f9b0e792e91ce87134b0f4bfe17677d9248cb5337f3fbf3a8e157942a
|
|
Start time: Tue Mar 25 12:00:10 2014
|
|
End time: Tue Mar 25 12:00:10 2014
|
|
Duration: 0.08 seconds
|
|
Number of files: 358
|
|
Original size Compressed size Deduplicated size
|
|
This archive: 57.16 MB 46.78 MB 151.67 kB
|
|
All archives: 114.02 MB 93.46 MB 44.81 MB
|
|
|
|
See the :ref:`quickstart` chapter for a more detailed example.
|
|
|
|
Easy installation
|
|
-----------------
|
|
You can use pip to install |project_name| quickly and easily::
|
|
|
|
$ pip3 install borgbackup
|
|
|
|
Need more help with installing? See :ref:`installation`.
|
|
|
|
User's Guide
|
|
============
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
foreword
|
|
installation
|
|
quickstart
|
|
usage
|
|
faq
|
|
internals
|
|
|
|
Getting help
|
|
============
|
|
|
|
If you've found a bug or have a concrete feature request, please create a new
|
|
ticket on the project's `issue tracker`_ (after checking whether someone else
|
|
already has reported the same thing).
|
|
|
|
For more general questions or discussions, IRC or mailing list are preferred.
|
|
|
|
IRC
|
|
---
|
|
Join us on channel #borgbackup on chat.freenode.net. As usual on IRC, just
|
|
ask or tell directly and then patiently wait for replies. Stay connected.
|
|
|
|
Mailing list
|
|
------------
|
|
|
|
There is a mailing list for Borg on librelist_ that you can use for feature
|
|
requests and general discussions about Borg. A mailing list archive is
|
|
available `here <http://librelist.com/browser/borgbackup/>`_.
|
|
|
|
To subscribe to the list, send an email to borgbackup@librelist.com and reply
|
|
to the confirmation mail. Likewise, to unsubscribe, send an email to
|
|
borgbackup-unsubscribe@librelist.com and reply to the confirmation mail.
|