borg/docs/index.rst

49 lines
1.2 KiB
ReStructuredText
Raw Normal View History

2013-06-29 21:56:44 +00:00
.. include:: global.rst.inc
2011-11-05 18:42:28 +00:00
2013-08-01 11:23:15 +00:00
Welcome to Attic
================
2013-07-08 21:38:27 +00:00
|project_name| is a deduplicating backup program written in Python.
2013-07-03 20:38:07 +00:00
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|
2013-07-05 10:32:56 +00:00
suitable for daily backups since only actual changes are stored.
2011-11-05 18:42:28 +00:00
2011-11-06 15:59:14 +00:00
2013-06-29 21:56:44 +00:00
Easy to use
2011-11-05 18:42:28 +00:00
-----------
2013-07-03 20:38:07 +00:00
Initialize a new backup :ref:`repository <repository_def>` and create your
first backup :ref:`archive <archive_def>` in two lines::
2011-11-06 15:59:14 +00:00
2013-07-08 21:38:27 +00:00
$ attic init /usbdrive/my-backup.attic
$ attic create -v /usbdrive/my-backup.attic::documents ~/Documents
2011-11-05 18:42:28 +00:00
2013-07-31 18:51:01 +00:00
See the :ref:`generalusage` section for a more detailed example.
2011-11-05 18:42:28 +00:00
2013-06-29 21:56:44 +00:00
Easy installation
2011-11-06 15:59:14 +00:00
-----------------
2013-06-29 21:56:44 +00:00
You can use pip to install |project_name| quickly and easily::
2011-11-05 18:42:28 +00:00
2013-07-08 21:38:27 +00:00
$ pip install attic
2011-11-05 18:42:28 +00:00
2013-07-31 18:51:01 +00:00
Need more help with installing? See :ref:`installation`.
2011-11-05 18:42:28 +00:00
2013-06-29 21:56:44 +00:00
User's Guide
============
2011-11-05 18:42:28 +00:00
2013-06-29 21:56:44 +00:00
.. toctree::
:maxdepth: 2
2011-11-05 18:42:28 +00:00
2013-07-31 18:51:01 +00:00
foreword
2013-06-30 19:30:17 +00:00
installation
2013-07-31 18:51:01 +00:00
quickstart
2013-08-04 19:23:12 +00:00
usage
2013-06-29 21:56:44 +00:00
faq
2011-11-05 18:42:28 +00:00
2013-06-29 21:56:44 +00:00
Contribute
==========
2011-11-05 18:42:28 +00:00
2013-07-08 19:19:50 +00:00
Found a bug? Have any ideas to improve |project_name|? Add bug reports and
feature requests to the `issue tracker`_.
2011-11-05 18:42:28 +00:00
2013-07-03 20:38:07 +00:00
You can also ask the author a question directly by
`email <mailto:jonas@borgstrom.se>`_.