Nominatim

A tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding).

  • Media Applications
  • Other
  • Productivity
  • Tools & Utilities
  • Web & Publishing
A tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding).

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

72/100 Good

Maintained
100last commit 24 days ago
Popular
734,541 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
2032 GB minimum RAM, runs on ARM

Availability: platform listings confirmed today, links checked 8 days ago

GitHub stars
4,541
Open issues
102
Last commit
2026-10-28
Latest release
v5.3.3
License
GPL-3.0
Activity
declining

Checked 23 days ago - source: GitHub (osm-search/Nominatim)

Resources & Compatibility

Minimum requirements: 32 GB RAM, 500 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Make a project folder first Run mkdir ~/nominatim-project and then cd into it before setting up the rest of Nominatim. This folder is where Nominatim keeps its settings and data, so having one dedicated place makes backups and later updates less likely to break things. source
  • Load the map data you want After setup, run nominatim import --osm-file <data file> to load the OpenStreetMap data you want Nominatim to search. Without this import, the app has no locations, so address searches will not return useful results. source
  • Turn on the Nominatim service Run the listed systemctl commands to enable and start nominatim.socket (the network listener) and nominatim.service (the main program). This makes Nominatim answer requests and keeps it running automatically after a reboot. source
  • Docker configuration Review the image README for all supported container parameters before starting Nominatim. source

Fetched 46 days ago - each note links to its source

Alternatives (1)

  • sthan.io - sthan.io is a set of REST APIs for working with US addresses, made for developers and the teams they build for.

Checked 51 days ago - source: AlternativeTo

Common questions

Do I need to load OpenStreetMap data after installing Nominatim?

Yes. Run nominatim import --osm-file with the desired OSM file; without an import, address searches will not return useful results.

How should I back up a Nominatim installation?

Keep Nominatim in a dedicated project folder, such as ~/nominatim-project. Back up that folder, because it holds the settings and data Nominatim uses.

How do I make Nominatim start automatically on Ubuntu?

Enable and start nominatim.socket, the network listener, and nominatim.service, the main program. This makes Nominatim answer requests and keeps it running automatically after a reboot.

Why can my web server not use Nominatim?

The web server user needs access to the Nominatim database. On default Ubuntu, that user is www-data.

Are there request limits on a self-hosted Nominatim instance?

The public server allows one request per second, and longer jobs are reduced to four requests per minute. Your own server has no limits.

Answers sourced from eohne.github.io, nominatim.org, nominatim.org, nominatim.org

Community

Collected 48 days ago - public community threads