From 4751deb20b014f03ba4fa8ea1996ef9c71befad1 Mon Sep 17 00:00:00 2001
From: Pierre-Yves Chibon <pingou@pingoured.fr>
Date: Jul 28 2015 12:47:53 +0000
Subject: Add a documentation on how to install pagure's web components


---

diff --git a/doc/Install.rst b/doc/Install.rst
new file mode 100644
index 0000000..98a2844
--- /dev/null
+++ b/doc/Install.rst
@@ -0,0 +1,85 @@
+Installing pagure
+=================
+
+There are two ways to install pagure:
+
+* via the RPM package (recommanded if you are using a RPM-based linux distribution)
+* via the setup.py
+
+
+
+Installing pagure via RPM
+-------------------------
+
+Here as well there are two ways of obtaining the RPM:
+
+* From the main repositories
+
+Pagure is packaged for Fedora since Fedora 21 and is available for RHEL and
+its derivative via the `EPEL repository <>`. So installing it is as easy as:
+::
+
+    dnf install pagure pagure-milters pagure-ev
+
+or
+::
+    yum install pagure pagure-milters pagure-ev
+
+The ``pagure`` package contains the core of the application and the doc server.
+(See the ``Overview`` page for a global overview of the structure of the
+project).
+
+The ``pagure-milters`` package contains, as the name says, the milter.
+
+The ``pagure-ev`` package contains the eventsource server.
+
+..note: The last two packages are optional, pagure would work fine without
+        them.
+
+* From the sources
+
+If you wish to run a newer version of pagure than what is in the repositories
+you can easily rebuild it as RPM.
+
+Simply follow these steps:
+# Clone the sources::
+    git clone https://pagure.io/pagure.git
+
+# Go to the folder::
+    cd pagure
+
+# Build a tarball of the latest version of pagure::
+    python setup.py sdist
+
+# Build the RPM::
+    rpmbuild -ta dist/pagure*.tar.gz
+
+This will build pagure from the version present in your clone.
+
+
+Once, the RPM is installed, the services ``pagure_milter`` and ``pagure_ev``
+are ready to be used but the database and the web-application parts still
+need to be configured.
+
+
+
+Installing pagure via setup.py
+------------------------------
+
+Pagure includes in its sources a ``setup.py`` automatint the installation
+of the web applications of pagure (ie: the core + the doc server).
+
+
+To install pagure via this mechanism simply follow these steps:
+# Clone the sources::
+    git clone https://pagure.io/pagure.git
+
+# Go to the folder::
+    cd pagure
+
+# Install the latest version of pagure::
+    python setup.py build
+    sudo python setup.py install
+
+..note: To install the eventsource server or the milter, refer to their
+        respective documentations.