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</http:>

          on how to `deploy Flask application with WSGI and apache

          <http: deploying="" docs="" flask.pocoo.org="" mod_wsgi="">`_.</http:>

For testing

-----------

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