OSV is an open source project created by John McKerrell and  launched in September 2009. It is an open licensed database of street level photography, In which all data by moderation of different users gets added to OSM project, where the resultant data gets published by the project’s license and legal terms.

In OSV, user adds the photos which gets to pending, processing and the unavailable state(where data is not available to view publically), and then to moderated state (where photos are moderated by 3 users, then available (means photos are appropriate to publish).Also to safeguard the project against problems in the future users can manually masking any parts of the photo that could cause privacy problems or any problems for the project in the future, for instance faces of people or car license plates. The available state photos then added to the OSM with the license and legal terms.

Installation of OpenStreetView:

You can install OSV on your server. Here are installation steps that will help you to have your own OSV installed on your server..

Step 1: Install the requirement of OSV:

You need to have  Lamp installed to run OSV on your server ( localhost). You can install Lamp from here.

Open the terminal and run the following command :
 $ sudo apt-get install mysql-server mysql-client
 $ sudo apt-get install ruby1.8-dev
 $sudo apt-get install rubygems
 $ sudo gem install rails -v 2.3.18
 $sudo apt-get install libmysql-ruby
 $sudo apt-get install libmysqlclient-dev
 $sudo apt-get install rubygems  rake  gem
 $sudo apt-get install libopenssl-ruby1.8
$sudo apt-get install ruby-full build-essential

Install required gems:

$sudo gem install rubyist-aasm -v=2.1.1
$sudo gem install mini_magick -v=3.8.0
$sudo gem install exifr -v=1.1.3
$sudo gem install json -v=1.8.1
$sudo gem install aasm -v=3.3.1
$sudo gem install rake -v=0.8.7
$sudo gem install rdoc -v=2.4.0
$sudo gem install slimgems -v=
$sudo gem install sqlite3 -v=1.3.9

Now your environment is set.

Note: Verify the versions of your packages with this documentation, because many packages are updated now and many things are deprecated.

Step 2: Create a database for OSV

mysql -u root -p (Enter your Mysql password Now)
 create database openstreetview_org_development;
 Control + d

 Step 3:  Clone the github repo to local machine using git

$git clone --recursive

Step 4: Change the config file

$cd OpenStreetView/config
$sudo gedit database.yml

It will Open the database.yml in Geditor. This file contain the Information regarding the Database connection for OSV So Carefully do as:
a)Change user and password of MySQL and socket as follow
socket: /var/run/mysqld/mysqld.sock

Now edit the other file as:
$sudo gedit environment.rb
Change server name from ‘’ to ‘localhost:3000’ in line number 7.  In line number 4, make version for RAILS_GEM_VERSION as ‘2.3.18’

Step 5:  Plugin for managing user authentication


$cd vendor/plugins/
 $git clone --recursive restful_authentication
$cd .. 
$sudo rake gems:install
$cd ..

Step 6: Configure a mail server

$sudo gem install tlsmail -v=0.0.1

tslmail is a mail server and to configure it
$gedit OpenStreetView/config/environments/development.rb
edit this line

SERVER_URL = ‘localhost:3000’ # here 3002 port changed to 3000

and add this code into it

require ‘tlsmail’
ActionMailer::Base.delivery_method = :smtp

ActionMailer::Base.perform_deliveries = true
ActionMailer::Base.raise_delivery_errors = true
ActionMailer::Base.smtp_settings = {
:enable_starttls_auto => true,
:address => ‘’,
:port => 587,
:tls => true,
:domain => ‘’, #you can also use
:authentication => :plain,
:user_name => ‘’,    # your email id
:password => ‘abc’      # your password



Step 7:  Build and Run

$cd OSV/OpenStreetView
 $rake db:migrate RAILS_ENV="development"

The script/server will Start the server , Now you Can run the OSV at localhost as: http://localhost:3000
Note: If you get an error on $rake like this,


then install slimgems

$sudo gem install slimgems

After successful installation, You can use it 🙂



Now you can create your account and upload photos.

Here is the presentation by John McKerrel on OpenStreetView:


About Jasleen Kaur

Hi, I am Jasleen kaur, a Computer Science Student.
This entry was posted in Uncategorized. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s