[[TOC()]]
= !GeoDjango Ubuntu Installation =

The GeoDjangoInstall wiki describes in detail how to install GeoDjango dependencies from source, which for many reasons is the ideal approach. However, with the recent Ubuntu releases you can also use the Synaptic Package Manager (apt-get install on the command line) to handle much of the installation work for you.

== Short Version ==
 * Django from trunk
 * Add the Ubuntu universe and multiverse debs
 * Update and upgrade Ubuntu with Apt-get
 * easy_install Pycopg2
 * If you need Postgres and Apache apt-get 'em
  * make sure to grab the dev versions
  * make sure you edit pg_hba.conf to allow django
 * Apt-get postgis, libgdal, libgeos, and proj
 * Create your PostGIS enabled PostgreSQL db

== Full Instructions ==

=== Step 1 ===
Add the universe and multiverse debian repositories

{{{
#if you have the desktop edition
sudo gedit /etc/apt/sources.list
#if you have the server edition
sudo nano /etc/apt/sources.list
# if you know how to use vim, you probably don't need to be reading this page!
sudo vim /etc/apt/sources.list
## Add these Universe / Multiverse sites to the bottom of the page
## Make sure to specify the correct Ubuntu version
deb http://archive.ubuntu.com/ubuntu gutsy universe multiverse
deb-src http://archive.ubuntu.com/ubuntu gutsy universe multiverse
deb http://archive.ubuntu.com/ubuntu gutsy-security universe multiverse
deb-src http://archive.ubuntu.com/ubuntu gutsy-security universe multiverse
deb http://archive.ubuntu.com/ubuntu gutsy-updates universe multiverse
deb-src http://archive.ubuntu.com/ubuntu gutsy-updates universe multiverse
}}}

=== Step 2 ===
Then upgrade and update ubuntu based on these new sources
{{{
apt-get update
apt-get upgrade
}}}

=== Step 3 ===
Use easy_install to install psycopg2
{{{
wget http://peak.telecommunity.com/dist/ez_setup.py
sudo python ez_setup.py
sudo easy_install psycopg2
}}}

=== Step 4 ===
Install Apache and PostgreSQL (if you need them)
{{{
apt-get install apache2 apache2-threaded-dev apache2-doc apache2-mpm-prefork apache2-utils ssl-cert  
}}}
{{{
sudo apt-get install postgresql postgresql-contrib postgresql-server-dev-8.3
}}}