= Installation Guidelines: Linux - Developer (Manual) =

Examples are shown for Debian-based systems.

Because of this wiki being based on a Debian system, it is assumed that all systems are running with the "sudo" command. Remember to put "sudo" before every command with apt-get! (For example, instead of "apt-get python2.7" the command would be "sudo apt-get python2.7).
== Install Python ==
The latest Python 2.7 version is currently recommended.

For Debian-based systems like Ubuntu:
{{{
sudo su -
apt-get install python2.7
}}}

== Install Python Libraries ==
Linux users should generally use the packages provided for their specific distribution, where available.

==== Mandatory ====
 * [http://codespeak.net/lxml lxml] for XML export/import
 * [http://pypi.python.org/pypi/Shapely/ Shapely] for GIS Features
 * [http://www.reportlab.com/software/opensource/rl-toolkit/download/ ReportLab] for PDF output
 * [http://www.pythonware.com/products/pil/ PIL] Python Image Library for PDFs
 * [http://labix.org/python-dateutil dateutil]

On Debian-based systems, like Ubuntu:
{{{
sudo su -
apt-get install python-lxml
apt-get install python-shapely
apt-get install python-reportlab
apt-get install python-imaging
apt-get install python-dateutil
}}}
==== Optional ====
 * [http://pypi.python.org/pypi/xlwt xlwt] for XLS output: {{{apt-get install python-xlwt}}}
 * [http://pypi.python.org/pypi/xlrd xlrd] for XLS output & reading spreadsheets (used by survey to import data held on a spreadsheet) {{{apt-get install python-xlrd}}}

 * [http://numpy.scipy.org  numpy] required by matplotlib
 * [http://www.scipy.org/Installing_SciPy SciPy] required for S3Cube
 * [http://matplotlib.sourceforge.net/users/installing.html MatPlotLib] for charts (used in the Survey & Delphi applications & for the S3Cube pivottable reports)

 * [http://pypi.python.org/pypi/setuptools/ setuptools] for installing tweepy
 * [http://pypi.python.org/pypi/tweepy/ tweepy] python library to interact with twitter
 * [http://sourceforge.net/projects/pyserial/files/ Pyserial] for SMS Features 

 * [http://pypi.python.org/pypi/pytz/ PyTZ] for Timezone awareness
 * [http://pypi.python.org/pypi/pywurfl/ PyWURFL] for Browser Capabilities (unused currently)

 * [http://pypi.python.org/pypi/MySQL-python/ MySQLDB for accessing MySQL databases]: {{{apt-get install python-mysqldb}}}
 * [http://initd.org/psycopg/ Psycopg for accessing PostgreSQL databases]: {{{apt-get install python-psycopg2}}}

== Install git ==
We use the [http://git-scm.com/ git] Distributed Version Control System. It is available on the most package servers. The package name on Ubuntu and Debian (apt-get/aptitude) is "git-core", for the most distibutions using rpm, like Fedora or RHEL, it is just "git". 

If you want to develop using the "forks"-feature of GitHub (which are basically branches - but in your own repository) or by commiting code directly to the eden repository, you have to [https://github.com/signup/free create a GitHub account].
After that you can setup your GIT by configuring your SSH keys and accountdata. A pretty good tutorial is available at the [http://help.github.com/linux-set-up-git/ GitHub-Manual].
== Next ==
Install Web2Py & Sahana:
 * InstallationGuidelines/Developer/PostPython