Re-add the running locally how-to
@@ -37,6 +37,88 @@ $ docker-compose build # rebuild them to load the changes and install anything
$ docker-compose up # restart the containers
```
+## Running locally
+
+Get the Plenario source:
+
+``` bash
+git clone git@github.com:UrbanCCD-UChicago/plenario.git
+```
+
+Install support libraries for Python:
+
+``` bash
+cd plenario
+pip install -r requirements.txt
+```
+
+If you aren't already running [PostgreSQL](http://www.postgresql.org/),
+we recommend installing version 9.3 or later.
+
+Make sure the host of your database has the [PostGIS](http://postgis.net/)
+extension installed.
+
+The following command creates a postgres database, imports the
+plv8 and postgis extensions, and creates all the necessary tables for
+plenario to work. The database name corresponds with the `DB_NAME`
+setting in your `plenario/settings.py` file and can be modified. It will
+be set to `plenario_test` by default.
+
+```
+./manage.py init
+```
+
+You'll need the ogr2ogr utility - part of the gdal package. We use it to import and export shape datasets.
+
+OSX
+```
+brew install gdal --with-postgresql
+```
+
+Ubuntu/Debian
+
+```
+sudo apt-get install gdal-bin
+```
+
+The default settings should work given a typical postgres setup, however
+should you find that the init method fails to run - the first place to
+check would be the `settings.py` file.
+
+You will likely want to change, at minimum, the following `settings.py`
+fields:
+
+* `DATABASE_CONN`: edit this field to reflect your PostgreSQL
+ username, server hostname, port, and database name.
+
+* `DEFAULT_USER`: change the username, email and password on the
+administrator account you will use on Plenario locally.
+
+Before running the server, [Redis](http://redis.io/) needs to be running.
+
+* To start Redis locally (in the background):
+
+```
+redis-server &
+```
+
+Start up a worker:
+
+```
+./manage.py worker
+```
+
+Finally, run the server:
+
+```
+./manage.py runserver
+```
+
+Once the server is running, navigate to http://localhost:5000/ . From
+the homepage, click 'Login' to log in with the username and password
+from `settings.py`. Once logged in, go to 'Add a dataset' under the
+'Admin' menu to add your own datasets.
+
## Tools we are grateful for:
### Application Dependencies
