Revision 1 as of 2012-03-30 17:45:41

Clear message
Italiano English
Edit History Actions


Nodeshot is an easy to use Wireless Community MapServer made by the Ninux Community. One instance can be find on their website. It's based on Django. This page aims at providing a tutorial on how to install an instance of this software.

Requirements Before starting the installation be sure to have a server ready with the following software:

* Linux OS * Python > 2.5 * Django > 1.4 (GenericIPAddressField for IPV6 was added in 1.4) * Web server (eg: apache, nginx) - alternatively you can use the django development server (for development production only) * database (mysql, postgresql, sqlite3 and others :: see

Installing Django Installing django is out of the scope of this document, for that please check the official django documentation: . We advise to install the latest development version from svn or git so it's easy to upgrade.

In a production environment you must setup a VIRTUAL HOST in your webserver and to enable MOD_PYTHON or MOD_WSGI in order to get Nodeshot to work. That's also out of the scope of this guide because the way you want to do that might vary depending on distribution, habits, ecc.

if you use mod_wsgi this is the code you need to get it to work (create a file caled

import os import sys sys.path.append(os.path.dirname(os.path.realpath(file))) os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'

import django.core.handlers.wsgi application = django.core.handlers.wsgi.WSGIHandler()

1. Choose the folder where you want to store the code of the project and clone the git repository with: git clone

2. rename the folder created by git with a different name than "nodeshot" (this prevents python in getting confused on some systems), eg: mapserver

mv nodeshot mapserver

cd mapserver

3. Create the database for nodeshot if using mysql or postgresql create a new database in the web admin tool or via command line

MySQL: Set up a database for MySQL for the root user and a password e.g. "Nodeshotpassword"

mysql -uroot -pNodeshotpassword

sqlite3 doesn't need you to create anydatabase, indicate the absolute path were you want django to create the file for example "/home/USER/mapserver/nodeshot.db"

4. Then edit the settings of nodeshot in the nodeshot folder. a) Create by copying with the following command line cp b) Edit the settings example edit c) Fill in the following database information

set TIME_ZONE to your area set LANGUAGE_CODE to your language set SITE_URL to your URL (localhost if in development environment) set NODESHOT_GMAP_CENTER, change the coordinates of the center of the map to your area set NODESHOT_SITE (name and domain) edit NODESHOT_KML['description'] to a description that suits your community (optional) edit NODESHOT_ROUTING_PROTOCOLS and choose the ones that are used in your network set NODESHOT_DEFAULT_ROUTING_PROTOCOL to the prefered choice


  • META_ROBOTS: this indicates if you want Google to index your map-server or not. Possible choices are the ones indicated here SHOW_STATISTICS: boolean that indicates if you want to show the number of active nodes, potential nodes, hotspots, links and total link surface on the website SHOW_KML_LINK: this indicates if you want to show the KML feed icon and link HELP_URL: set up an URL on your website to explain how to use the map-server or whatever you need to tell to your users (this might change in the future, maybe is better to ship some instrctions with the core code)

5. create the database structure $ python syncdb this command creates the SQL tables and asks you to If not working, try this command with mapserver as working directory sudo chown www-data. .