Overview

LodgeIt Readme

Lodgeit implements a pastebin and some scripts to paste the service.

Installation

LodgeIt requires at least Python 2.5 to work correctly. Next to this LodgeIt has quite a few of dependencies as well as a nice bootstrap process. This is documentated on the following slides.

Dependencies and virtual environment

To get LodgeIt work properly we need those dependencies: Python (at least 2.5), python-setuptools and mercurial.

For Ubuntu (or any Debian based distribution) use aptitude to install:

aptitude install python-dev python-setuptools python-virtualenv mercurial

Now we can install LodgeIt. But first we need to check out LodgeIt from the mercurial repository. To do that you create a new folder lodgeit-dev in your projects directory and change into it. There we initialize the virtual environment and check out LodgeIt (main branch):

hg clone http://dev.pocoo.org/hg/lodgeit-main lodgeit

Right before we can initialize the virtual environment we need to install some development packages to compile the python imaging library.

For Ubuntu again aptitude (as root):

sudo aptitude install build-essential
apt-get build-dep python-imaging

Now it's possible to install the virtual environment. This is done with a simple Python command:

# assumed that you are located in lodgeit-dev/lodgeit
python scripts/make-bootstrap.py > ../bootstrap.py
cd ..
# make sure that the virtualenv is not activated. If yes, execute `deactivate`
python bootstrap.py .

You are ready to run now.

Database and other things

We are now ready to enter the virtual environment (assumed you are located in lodgeit-dev/lodgeit):

. ../bin/activate

LodgeIt initializes it's database per default on /tmp/lodgeit.db, you can change that path in the manage.py by modifiing dburi.

Now start the development server:

python manage runserver

Enjoy!