Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
87 lines (56 sloc) 3.25 KB
F-or non-development installs we *highly* recommend using our standard
installation packages. Details here:
These packages are much easier to keep updated.
The following install instructions are geared for development setups or non-Ubuntu
1. Prerequisites: solr + jetty, python imaging library, python lxml bindings,
python-setuptools, virtualenv, gdal, postgresql with postgis. Here's how we
get these packages in Ubuntu 10.04 LTS:
$ sudo apt-get install python-setuptools solr-jetty python-lxml python-imaging
$ sudo apt-get install gdal-bin proj postgis python-psycopg2
$ sudo easy_install --upgrade virtualenv
2. Create a virtualenv. For more info, see
*Note*: We store some important site-specific data in the virtualenv, so don't
delete it without first backing up the share/localwiki directory inside it.
$ virtualenv env
Activate the new environment. Run all of the following commands in this environment:
$ source env/bin/activate
3. Install the localwiki package and its dependencies:
(env)$ python install
4. Allow the search, diff services to start & back up existing config. This will
differ between systems. We use this script on Ubuntu systems:
(env)$ sudo install_config/
Take a look at the script (it's short). You may need to
customize it for your particular OS.
5. Initialize the localwiki install:
(env)$ localwiki-manage setup_all
You'll be asked to sudo in order to create the postgres database.
You are now done configuring and installing things! You can start the built-in
Django development server:
(env)$ localwiki-manage runserver
Hooray! You can visit the site at
Note: For security/efficiency, the built-in server listens on only.
For real deployments you'll want to set up apache.
See for more instructions.
Note: You'll want to run source env/bin/activate every time you want to access
the localwiki-manage command.
We've really only tested things on Ubuntu Server Edition 10.04 LTS. It should
be very possible to run this on any Unix-y system. You'll need to:
* Hunt down the correct prerequisites for Step 1.
* Make sure that Step 5 is completed. Take a peek at install_config/
to see what it's doing. It's simple stuff, really, but the configuration files
may be in a different spot on your system.
Help us document this stuff! Add something to or
the github wiki.
== Database Note ==
This setup assumes we're using PostgreSQL and its geographic companion,
PostGIS. You should in theory be able to use any supported Django database.
If you'd like to do something more specialized, please see the general Django
install instructions here:
and the GeoDjango install instructions here:
Jump to Line
Something went wrong with that request. Please try again.