Deployment
==========

From sources
------------

Clone the source::

 git clone http://git.fedorahosted.org/git/pagure.git

Install the dependencies listed in the ``requirements.txt`` file.


Copy the configuration files::

  cp pagure.cfg.sample pagure.cfg

Adjust the configuration files (secret key, database URL, admin group...).
See :doc:`configuration` for detailed information about the configuration.


Create the database scheme::

   PAGURE_CONFIG=/path/to/pagure.cfg python createdb.py

Create the folder that will receive the different git repositories:

::

    mkdir {repos,docs,forks,tickets}


Set up the WSGI as described below.


From system-wide packages
-------------------------

Start by install pagure::

  yum install pagure

Adjust the configuration files: ``/etc/pagure/pagure.cfg``.
See :doc:`configuration` for detailed information about the configuration.

Find the file used to create the database::

  rpm -ql pagure |grep createdb.py

Create the database scheme::

   PAGURE_CONFIG=/etc/pagure/pagure.cfg python path/to/createdb.py

Set up the WSGI as described below.


Set-up WSGI
-----------

Start by installing ``mod_wsgi``::

  yum install mod_wsgi


Then configure apache::

 sudo vim /etc/httd/conf.d/pagure.conf

uncomment the content of the file and adjust as desired.


Then edit the file ``/usr/share/pagure/pagure.wsgi`` and
adjust as needed.


Then restart apache and you should be able to access the website on
http://localhost/pkgdb


.. note:: `Flask <http://flask.pocoo.org/>`_ provides also  some documentation
          on how to `deploy Flask application with WSGI and apache
          <http://flask.pocoo.org/docs/deploying/mod_wsgi/>`_.


For testing
-----------

See :doc:`development` if you want to run pagure just to test it.