mirror of https://github.com/borgbackup/borg.git
Merge pull request #412 from anarcat/install-docs-nitpick
Install docs nitpick
This commit is contained in:
commit
eefc137ec9
|
@ -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. ::
|
||||
|
|
Loading…
Reference in New Issue