QML JavaScript Python HTML Other
Pull request Compare This branch is 52 commits behind kartoza:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Stories in Ready

A simple tool for getting stats for an openstreetmap area.

See http://linfiniti.com/2012/12/holiday-openstreetmap-project-for-swellendam/

You can also use this tool to download OSM shapefiles with a nice QGIS canned style for OSM roads and buildings for the area of your choosing.


Docker install

This will install and setup a postgis (kartoza/postgis) and an osm-reporter (kartoza/osm-reporter) container and then run the application with the source code from osm-reporter mounted into the osm-reporter container.

sudo apt-get install python-pip git
sudo pip install docker-compose
git clone git://github.com/kartoza/osm-reporter.git
cd osm-reporter
docker-compose up -d

Now make an nginx reverse proxy (or apache2 if you prefer) pointing to the running container. e.g.:

upstream osm-reporter {

server {

    # OTF gzip compression
    gzip on;
    gzip_min_length 860;
    gzip_comp_level 5;
    gzip_proxied expired no-cache no-store private auth;
    gzip_types text/plain application/xml application/x-javascript text/xml text/css application/json;
    gzip_disable “MSIE [1-6].(?!.*SV1)”;

    # the port your site will be served on
    listen      80;
    # the domain name it will serve for
    server_name osm.linfiniti.com osm.kartoza.com osm.inasafe.org;
    charset     utf-8;

    # max upload size, adjust to taste
    client_max_body_size 15M;

    location / {
        proxy_pass http://osm-reporter;

Manual Install for deployment


sudo apt-get install osm2pgsql postgis

Or under OSX::

brew install osm2pgsql

If you install Postgres9.3.app you will get pgsql2shp on OSX.

Ensure that the above binaries are in your path. If running on OSX you will need to ensure that /Applications/Postgres93.app/Contents/MacOS/bin/ is in the path of the user running the server.

You should also give the process that osm-reporter runs as createdb rights (needed to support the shape downloading feature). You should also have a postgis template named 'template_postgis' available on your system. Consult a postgis tutorial online to see how this is done.

First clone::

cd /home/web
git clone git://github.com/timlinux/osm-reporter.git

Then setup a venv::

cd osm-reporter
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Then deploy under apache mod_wsgi::

cd apache
cp osm-reporter.apache.conf.templ osm-reporter.apache.conf

Modify the contents of osm-reporter.apache.conf to suite your installation. Then do ::

sudo apt-get install libapache2-mod-wsgi
cd /etc/apache/sites-available
sudo ln -s /home/web/osm-reporter/apache/osm-reporter.apache.conf .
sudo a2ensite osm-reporter.apache.conf

The default configuration assumes a user named 'osm-reporter' exists on your system that the wsgi process will run under. If you wish to follow this convention you should create the user::

sudo useradd osm-reporter

And also give that user a database account (needed for the shape download feature) and database create permissions::

createuser osm-reporter
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n

If deploying locally you can leave the apache conf file mostly unchanged and add this to your /etc/hosts file::       osm-reporter.localhost

Next restart apache::

sudo service apache2 restart

Now test - open chrome and visit: http://osm-reporter.localhost

Manual install for development

Follow the install above and stop after setting up a venv. You don't need to configure apache, there is a lightweight development web server. You can run it::

python runserver.py

and then visit


You can optionally define a 'config' python module to override the default behaviour of OSM-Reporter.

You can create the python wherever you want, and then you will need to add the environment var REPORTER_CONFIG_MODULE to make reporter aware of it. For example::

export REPORTER_CONFIG_MODULE="path.to.the.module"

Then you can override the config properties to fit your need. Note that you can override only the properties you need to, the other will fallback to default values. For inspiration, you can have a look at :file:reporter/config/default.py

Available config


(list) valid OSM users names of people actively working on your data
    gathering project


(str) default bbox to use for the map and the stats;
    format is: "{SW_lng},{SW_lat},{NE_lng},{NE_lat}


(bool) either to display or not the "update stats" button on the map


(str) path to a dir where to cache the OSM files used by the backend


(list) tag names available for stats (default: ['building', 'highway'])

OSM2PGSQL_OPTIONS : (str) options for the osm2pgsql command line


On some computers with less RAM than servers, you may adapt the import into postgis with osm2pgsql. For instance in your 'config' python module above :: OSM2PGSQL_OPTIONS = '--cache-strategy sparse -C 1000'

Tests and QA

There is a test suite available, you can run it using nose e.g.::

PYTHONPATH=`pwd`/reporter:`pwd`:${PYTHONPATH} nosetests -v --with-id \
--with-xcoverage --with-xunit --verbose --cover-package=reporter reporter


export PYTHONPATH=`pwd`/reporter:`pwd`:$PYTHONPATH:venv/lib/python2.7/site-packages/; \
nosetests -v --with-id  --with-xunit --verbose --cover-package=reporter reporter

Using Docker

docker-compose build test
docker-compose run test


We have Continuous Integration support via our Jenkins server at


At the above site you can see the test results for each commit that is made to the repository. The following jenkins shell commands were used in the configuration options::

export OSM_REPORTER_LOGFILE='/tmp/osm-reporter-jenkins.log'
rm -rf venv
virtualenv venv
venv/bin/pip install -r requirements.txt
export PYTHONPATH=`pwd`/reporter:`pwd`:`pwd`/venv/lib/python2.7/site-packages/
nosetests -v --with-id --with-xcoverage --with-xunit --verbose --cover-package=reporter reporter
#rm -f pylint.log
pylint --output-format=parseable --reports=y --rcfile=pylintrc reporter > pylint.log
pep8 --repeat --ignore=E203 --exclude venv,none.py . > pep8.log


Sentry is a service that collects exceptions and displays aggregate reports for them. You can view the sentry project we have running for osm-reporter here: http://sentry.linfiniti.com/osm-reporter/

Tim Sutton, Etienne Trimaille & Yohan Boniface