Virtualenv installation
-----------------------

This guide will help quickly get you up and running with a local copy of
Moksha.  It will run the Moksha WSGI application using the Paste threaded http
server, a single orbited daemon with an embeded MorbidQ stomp message broker,
SQLite SQLAlchemy and Feed databases, and an in-memory cache.  This setup is
meant to be dead-simple to get up and running, and is not designed for
production deployments.

This installation method has been tested with OSX, Fedora, and RHEL.
See the :doc:`RPMInstallation` for a deploying with RPM and mod_wsgi.

Installing the necessary dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You'll need the `virtualenv <http://pypi.python.org/pypi/virtualenv>`_ package.

.. code-block:: bash

    # yum -y install python-virtualenv gcc openssl-devel
    # yum-builddep -y python-lxml pyOpenSSL python-sqlite2


Getting the code
~~~~~~~~~~~~~~~~

.. code-block:: bash

    $ git clone git://git.fedorahosted.org/git/moksha


Starting
~~~~~~~~

.. code-block:: bash

    $ ./start-moksha

.. note::
   This script takes care of setting up your TurboGears2 virtual environment
   the first time it is run.  To drop into the virtualenv manually you can run
   `source tg2env/bin/activate` to enter it, and `deactivate` to leave it.


Stopping
~~~~~~~~

.. code-block:: bash

    $ ./stop-moksha


Using Moksha
~~~~~~~~~~~~

Now you can navigate your web browser to the following url:

`http://localhost:8080 <http://localhost:8080>`_

.. note::
   Going to `127.0.0.1` will not work properly with the current Orbited setup,
   so you must make sure to go to `localhost`.
