-
- git clone git://github.com/apenwarr/bup
-
- - Install the needed python libraries (including the development
- libraries). On Debian or Ubuntu, this is usually:
- apt-get install python2.6-dev python-fuse
- apt-get install python-pyxattr python-pylibacl
-
- Substitute python2.5-dev or python2.4-dev if you have an older system.
-
- Or on newer Debian/Ubuntu versions, you can try this:
-
- apt-get build-dep bup
-
- - Build the python module and symlinks:
-
- make
+
+ ```sh
+ git clone https://github.com/bup/bup
+ ```
+
+ - This will leave you on the master branch, which is perfect if you
+ would like to help with development, but if you'd just like to use
+ bup, please check out the latest stable release like this:
+
+ ```sh
+ git checkout 0.32
+ ```
+
+ You can see the latest stable release here:
+ https://github.com/bup/bup/releases.
+
+ - Install the required python libraries (including the development
+ libraries).
+
+ On very recent Debian/Ubuntu versions, this may be sufficient (run
+ as root):
+
+ ```sh
+ apt-get build-dep bup
+ ```
+
+ Otherwise try this:
+
+ ```sh
+ apt-get install python3.7-dev python3-fuse
+ apt-get install python3-pyxattr python3-pytest
+ apt-get install python3-distutils
+ apt-get install pkg-config linux-libc-dev libacl1-dev
+ apt-get install gcc make acl attr rsync
+ apt-get isntall python3-pytest-xdist # optional (parallel tests)
+ apt-get install par2 # optional (error correction)
+ apt-get install libreadline-dev # optional (bup ftp)
+ apt-get install python3-tornado # optional (bup web)
+
+ ```
+ Or, if you can't yet migrate to Python 3 (please try to soon):
+
+ ```sh
+ apt-get install python2.7-dev python-fuse
+ apt-get install python-pyxattr python-pytest
+ apt-get install pkg-config linux-libc-dev libacl1-dev
+ apt-get install gcc make acl attr rsync
+ apt-get isntall python-pytest-xdist # optional (parallel tests)
+ apt-get install par2 # optional (error correction)
+ apt-get install libreadline-dev # optional (bup ftp)
+ apt-get install python-tornado # optional (bup web)
+ ```
+
+ On CentOS (for CentOS 6, at least), this should be sufficient (run
+ as root):
+
+ ```sh
+ yum groupinstall "Development Tools"
+ yum install python2 python2-devel libacl-devel pylibacl
+ yum install fuse-python pyxattr
+ yum install perl-Time-HiRes
+ yum install readline-devel # optional (bup ftp)
+ yum install python-tornado # optional (bup web)
+ ```
+
+ In addition to the default CentOS repositories, you may need to add
+ RPMForge (for fuse-python) and EPEL (for pyxattr).
+
+ On Cygwin, install python, make, rsync, and gcc4.
+
+ If you would like to use the optional bup web server on systems
+ without a tornado package, you may want to try this:
+
+ ```sh
+ pip install tornado
+ ```
+
+ - Build:
+
+ ```sh
+ make
+ ```