diff --git a/docs/installation.rst b/docs/installation.rst index efe8dadbc..2506d4ec2 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -6,38 +6,47 @@ Installation There are different ways to install |project_name|: -- **distribution package** - easy and fast if a package is available for your - Linux/BSD distribution. -- **PyInstaller binary** - easy and fast, we provide a ready-to-use binary file +- :ref:`distribution-package` - easy and fast if a package is + available from your operating system. +- :ref:`pyinstaller-binary` - easy and fast, we provide a ready-to-use binary file that comes bundled with all dependencies. -- **pip** - installing a source package with pip needs more installation steps - and requires all dependencies with development headers and a compiler. -- **git** - for developers and power users who want to have the latest code or - use revision control (each release is tagged). +- :ref:`source-install`, either: + - :ref:`pip-installation` - installing a source package with pip needs + more installation steps and requires all dependencies with + development headers and a compiler. + - :ref:`git-installation` - for developers and power users who want to + have the latest code or use revision control (each release is + tagged). -Installation (Distribution Package) ------------------------------------ +.. _distribution-package: + +Distribution Package +-------------------- Some Linux and BSD distributions might offer a ready-to-use ``borgbackup`` package which can be installed with the package manager. As |project_name| is still a young project, such a package might be not available for your system -yet. Please ask package maintainers to build a package or, if you can package / -submit it yourself, please help us with that! +yet. * On **Arch Linux**, there is a package available in the AUR_. +.. _AUR: https://aur.archlinux.org/packages/borgbackup/ + +Please ask package maintainers to build a package or, if you can package / +submit it yourself, please help us with that! See :issue:`105` on +github to followup on packaging efforts. + If a package is available, it might be interesting to check its version and compare that to our latest release and review the :doc:`changes`. -.. _AUR: https://aur.archlinux.org/packages/borgbackup/ +.. _pyinstaller-binary: +Standalone binary +----------------- -Installation (PyInstaller Binary) ---------------------------------- - -The |project_name| binary is available on the releases_ page for the following -platforms: +|project_name| binaries (generated with `pyinstaller`_) are available +on the releases_ page for the following platforms: * **Linux**: glibc >= 2.13 (ok for most supported Linux releases) * **Mac OS X**: 10.10 (unknown whether it works for older releases) @@ -48,12 +57,18 @@ them into a directory in your ``PATH`` and then you can run ``borg``. If a new version is released, you will have to manually download it and replace the old version. +.. _pyinstaller: http://www.pyinstaller.org .. _releases: https://github.com/borgbackup/borg/releases -Installing the Dependencies ---------------------------- +.. _source-install: -To install |project_name| from a source package, you have to install the +From source +----------- + +Dependencies +~~~~~~~~~~~~ + +To install |project_name| from a source package (including pip), you have to install the following dependencies first: * `Python 3`_ >= 3.2.2. Even though Python 3 is not the default Python version on @@ -75,7 +90,7 @@ After you have installed the dependencies, you can proceed with steps outlined under :ref:`pip-installation`. Debian / Ubuntu -~~~~~~~~~~~~~~~ ++++++++++++++++ Install the dependencies with development headers:: @@ -91,7 +106,7 @@ Ubuntu this means your user is not in the ``fuse`` group. Add yourself to that group, log out and log in again. Fedora / Korora -~~~~~~~~~~~~~~~ ++++++++++++++++ Install the dependencies with development headers:: @@ -103,7 +118,7 @@ Install the dependencies with development headers:: Mac OS X -~~~~~~~~ +++++++++ Assuming you have installed homebrew_, the following steps will install all the dependencies:: @@ -117,7 +132,7 @@ FUSE for OS X, which is available as a pre-release_. .. _pre-release: https://github.com/osxfuse/osxfuse/releases Cygwin -~~~~~~ +++++++ .. note:: Running under Cygwin is experimental and has only been tested with Cygwin @@ -144,8 +159,8 @@ In case the creation of the virtual environment fails, try deleting this file:: .. _pip-installation: -Installation (pip) ------------------- +From pip +~~~~~~~~ Virtualenv_ can be used to build and install |project_name| without affecting the system Python or requiring root access. Using a virtual environment is @@ -172,9 +187,10 @@ activating your virtual environment:: pip install -U borgbackup +.. _git-installation: -Installation (git) ------------------- +From git +~~~~~~~~ This uses latest, unreleased development code from git. While we try not to break master, there are no guarantees on anything. ::