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.
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
$ git clone git://git.fedorahosted.org/git/moksha
$ ./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.
$ ./moksha-ctl.py start
You can also automatically tail the logs after starting by appending another subcommand.
$ ./moksha-ctl.py restart logs
$ ./moksha-ctl.py stop
Note
The ./moksha-ctl.py script contains a number of utilities. You can see a list by running $ ./moksha-ctl.py --help.
Now you can navigate your web browser to the following url:
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.