For documentation, please see the docs directory.
-Alternatively, visit https://f-droid.org/manual/
+Alternatively, visit [https://f-droid.org/manual/](https://f-droid.org/manual/)
Installing
----------
-The easiest way to install the fdroidserver tools is to use virtualenv and pip
-(if you are Debian/Ubuntu/Mint/etc, you can first try installing using
-`apt-get install fdroidserver`). First, make sure you have virtualenv
-installed, it should be included in your OS's Python distribution or via other
-mechanisms like dnf/yum/pacman/emerge/Fink/MacPorts/Brew. Then here's how to
-install:
+The easiest way to install the `fdroidserver` tools is on Ubuntu, Mint or other
+Ubuntu based distributions, you can install using:
+
+ sudo apt-get install fdroidserver
+
+For older Ubuntu releases or to get the latest version, you can get
+`fdroidserver` from the Guardian Project PPA (the signing key
+fingerprint is `6B80 A842 07B3 0AC9 DEE2 35FE F50E ADDD 2234 F563`)
+
+ sudo add-apt-repository ppa:guardianproject/ppa
+ sudo apt-get update
+ sudo apt-get install fdroidserver
+
+On OSX, `fdroidserver` is available from third party package managers,
+like Homebrew, MacPorts, and Fink:
+
+ sudo brew install fdroidserver
+
+For any platform where Python's `easy_install` is an option (e.g. OSX
+or Cygwin, you can use it:
+
+ sudo easy_install fdroidserver
+
+Python's `pip` also works:
+
+ sudo pip install fdroidserver
+
+The combination of `virtualenv` and `pip` is great for testing out the
+latest versions of `fdroidserver`. Using `pip`, `fdroidserver` can
+even be installed straight from git. First, make sure you have
+installed the python header files, virtualenv and pip. They should be
+included in your OS's default package manager or you can install them
+via other mechanisms like Brew/dnf/pacman/emerge/Fink/MacPorts.
+
+For Debian based distributions:
+
+ apt-get install python-dev python-pip python-virtualenv
+
+Then here's how to install:
git clone https://gitlab.com/fdroid/fdroidserver.git
cd fdroidserver
virtualenv env/
- . env/bin/activate
+ source env/bin/activate
pip install -e .
python2 setup.py install