Installation
RhodeCode is written entirely in Python, but in order to use it's full potential there are some third-party requirements. When RhodeCode is used together with celery You have to install some kind of message broker, recommended one is rabbitmq to make the async tasks work.
Of course RhodeCode works in sync mode also, then You don't have to install any third party apps. Celery will give You large speed improvement when using many big repositories. If You plan to use it for 7 or 10 small repositories, it will work just fine without celery running.
After You decide to Run it with celery make sure You run celeryd using paster and message broker together with the application.
Install from Cheese Shop
Rhodecode requires python 2.x greater than version 2.5
Easiest way to install rhodecode is to run:
easy_install rhodecode
Or:
pip install rhodecode
If you prefer to install manually simply grab latest release from http://pypi.python.org/pypi/rhodecode, decompress archive and run:
python setup.py install
Step by step installation example
- Assuming You have installed virtualenv create one using.
virtualenv --no-site-packages /var/www/rhodecode-venv
Note
Using --no-site-packages when generating your virtualenv is very important. This flag provides the necessary isolation for running the set of packages required by RhodeCode. If you do not specify --no-site-packages, it's possible that RhodeCode will not install properly into the virtualenv, or, even if it does, may not run properly, depending on the packages you've already got installed into your Python's "main" site-packages dir.
- this will install new virtualenv into /var/www/rhodecode-venv.
- Activate the virtualenv by running
source /var/www/rhodecode-venv/bin/activate
Note
If you're on UNIX, do not use sudo to run the virtualenv script. It's perfectly acceptable (and desirable) to create a virtualenv as a normal user.
- Make a folder for rhodecode somewhere on the filesystem for example
mkdir /var/www/rhodecode
- Run this command to install rhodecode
easy_install rhodecode
- this will install rhodecode together with pylons and all other required python libraries
Requirements for Celery (optional)
Note
Installing message broker and using celery is optional, RhodeCode will work without them perfectly fine.
Message Broker
For installation instructions You can visit: http://ask.github.com/celery/getting-started/index.html It's very nice tutorial how to start celery with rabbitmq