Open Source search based on OpenStreetMap data
Clone or download
Latest commit d1143b4 Sep 22, 2018
Failed to load latest commit information.
data rework repeatability change in data/words.sql Jul 22, 2018
docs docs: rewrite functions when migrating Sep 22, 2018
lib fix AddressDetails->getAddressDetails, add tests Sep 20, 2018
module Update nominatim.c Feb 25, 2018
munin Add some comments to help use munin plugin, add over limit detection Jan 14, 2014
mysql2pgsql add mysql to pgsql tool as lib Mar 18, 2013
nominatim Work on setup/update scripts, unit tests, and documentation to enable… Jul 21, 2018
osm2pgsql @ 93b73e5 update osm2pgsql to latest master Aug 17, 2018
settings delete PHP_BIN from default and add @PHP_BIN@ to passthru function in… Aug 23, 2018
sql import_osmosis_log table: increase possible batch size Sep 15, 2018
test Merge pull request #1189 from mtmail/classtypes-unit-tests Sep 22, 2018
utils Mute notices from postgresql during setup Aug 23, 2018
vagrant add vagrant and installation instructions for ubuntu 18 Aug 24, 2018
website unify address details lookup Jul 10, 2018
wikidata replace double-quoting with single quotes where applicable Oct 26, 2017
.gitignore move from autotools to cmake and update osm2pgsql Mar 12, 2016
.gitmodules update osm2pgsql to latest version Sep 29, 2012
.travis.yml On Travis phpcs only ran against tests/php/ directory Jul 23, 2018
AUTHORS prepare release 3.2.0 Aug 26, 2018
CMakeLists.txt prepare release 3.2.0 Aug 26, 2018 add a note about variable naming for PHP Jul 21, 2018
COPYING tabs-to-spaces Sep 4, 2016
ChangeLog prepare release 3.2.0 Aug 26, 2018 link CONTRIBUTING file from README file Sep 16, 2018 use real paths in BDD examples Mar 18, 2018
Vagrantfile add vagrant and installation instructions for ubuntu 18 Aug 24, 2018
phpcs.xml add PHPCS Squiz.Arrays.ArrayDeclaration.KeyNotAligned rule May 7, 2018

Build Status


Nominatim (from the Latin, 'by name') is a tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding). An instance with up-to-date data can be found at Nominatim is also used as one of the sources for the Search box on the OpenStreetMap home page.


The documentation of the latest development version is in the docs/ subdirectory. A HTML version can be found at .


The latest stable release can be downloaded from There you can also find installation instructions for the release.

Detailed installation instructions for the development version can be found at as well.

A quick summary of the necessary steps:

  1. Compile Nominatim:

     mkdir build
     cd build
     cmake ..
  2. Get OSM data and import:

     ./build/utils/setup.php --osm-file <your planet file> --all
  3. Point your webserver to the ./build/website directory.


The source code is available under a GPLv2 license.


Contributions are welcome. For details see [](contribution guide).

Both bug reports and pull requests are welcome.

Mailing list

For questions you can join the geocoding mailinglist, see