borg/docs/installation.rst

66 lines
1.7 KiB
ReStructuredText
Raw Normal View History

2013-06-30 19:30:17 +00:00
.. include:: global.rst.inc
.. _installation:
Installation
2013-07-31 18:51:01 +00:00
============
2013-06-30 19:30:17 +00:00
2013-07-03 20:38:07 +00:00
|project_name| requires Python_ 3.2 or above to work. Even though Python 3 is
not the default Python version on most Linux distributions, it is usually
2013-06-30 19:30:17 +00:00
available as an optional install.
Other dependencies:
* `msgpack-python`_ >= 0.1.10
* OpenSSL_ >= 1.0.0
* libacl_
2013-06-30 19:30:17 +00:00
2013-07-30 11:54:04 +00:00
The OpenSSL version bundled with Mac OS X and FreeBSD is most likey too old.
Newer versions are available from homebrew_ on OS X and from FreeBSD ports.
2013-06-30 19:30:17 +00:00
The llfuse_ python package is also required if you wish to mount an
archive as a FUSE filesystem.
Virtualenv_ can be used to build and install |project_name|
without affecting the system Python or requiring root access.
Common compilation pre-requisites
---------------------------------
The following Debian packages are generally necessary to compile
|project_name|, either through pip, the tarball or git::
$ sudo apt-get install python3 python3-dev python3-msgpack python3-sphinx libssl-dev libacl1-dev
2013-06-30 19:30:17 +00:00
Installing from PyPI using pip
------------------------------
To install |project_name| system-wide::
$ sudo pip3 install borgbackup
To install it in a user-specific account::
$ pip3 install --user borgbackup
Then add ``$HOME/.library/bin`` to your ``$PATH``.
2013-06-30 19:30:17 +00:00
Installing from source tarballs
-------------------------------
2013-07-08 19:19:50 +00:00
.. parsed-literal::
2013-06-30 19:30:17 +00:00
$ curl -O :targz_url:`Borg`
2013-07-08 21:38:27 +00:00
$ tar -xvzf |package_filename|
2013-07-08 19:19:50 +00:00
$ cd |package_dirname|
$ sudo python3 setup.py install
2013-06-30 19:30:17 +00:00
Installing from git
-------------------
2013-07-08 21:38:27 +00:00
.. parsed-literal::
2013-06-30 19:30:17 +00:00
2013-07-08 21:38:27 +00:00
$ git clone |git_url|
$ cd borg
$ sudo python3 setup.py install
Please note that when installing from git, Cython_ is required to generate some files that
are normally bundled with the release tarball.