Virtualenv installation (Other Linux distros, OSX, Windows, etc)

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 socket-proxy 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 Setting up a Moksha RPM & mod_wsgi environment (Fedora, RHEL, CentOS) for a deploying with RPM and mod_wsgi.

Installing the necessary dependencies

You’ll need the virtualenv package.

For Fedora/Red Hat/CentOS based environments:

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

On Ubuntu/Debian:

# apt-get install git python-dev python-virtualenv

Getting the code

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

Bootstrapping the environment

$ ./moksha-ctl.py bootstrap
$ ./moksha-ctl.py rebuild

Note

This script takes care of setting up your TurboGears2 virtual environment. To drop into the virtualenv manually you can run workon moksha to enter it, and deactivate to leave it.

Starting

$ ./moksha-ctl.py start

You can also automatically tail the logs after starting by appending another subcommand.

$ ./moksha-ctl.py restart logs

Stopping

$ ./moksha-ctl.py stop

Debugging

Note

The ./moksha-ctl.py script contains a number of utilities. You can see a list by running $ ./moksha-ctl.py --help.

Using Moksha

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

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.