Nominatim Docker

100% working container for Nominatim.

Quick Start

The easiest way to use Nominatim Docker is by pulling the pre-built images from Docker Hub.

To quickly get a Nominatim instance up and running with a small dataset (e.g., Monaco):

docker run -it \
  -e PBF_URL=https://download.geofabrik.de/europe/monaco-latest.osm.pbf \
  -p 8080:8080 \
  --name nominatim \
  mediagis/nominatim:5.3

After the import is complete, you can access the Nominatim API at http://localhost:8080/search?q=avenue%20pasteur.

Accessing Different Versions

You can pull specific versions of the Nominatim Docker image by specifying the tag. For example, to use Nominatim version 5.3:

docker pull mediagis/nominatim:5.3

For a list of available tags, please refer to the Docker Hub page.

Security Information

For information regarding the latest supported security version and security policies for Nominatim, please refer to the official Nominatim security documentation: Nominatim Security Policy.

Detailed Usage and Configuration

For comprehensive instructions on advanced configuration, importing custom PBF files, persistent data, updating the database, PostgreSQL tuning, and more, please refer to the detailed how-to guide.

Project goals and alternatives

It is the goal of this project to provide and easy to use container image that runs all services in a single container. The downside is that this makes the Dockerfile quite complex and harder to modify.

If you're looking for a project which separates the individual concepts into separate containers, check out https://github.com/smithmicro/n7m.

Contributors

Thanks goes to these wonderful people (emoji key):

Andrew 💻 📖	Donato Lucia 💻	Georgios Markakis 📖	Philip Kozeny 🚇 💻 ⚠️ 👀 📖	Cezary Morga 💻	Thomas Nordquist 💻
Andrey Ruíz 📖	UntitleDude 💻	Jack McKernan 💻	mtmail 📖 💻 💬 👀	Andrey Oblivantsev 💻	Simone 💻
DuncanMackintosh 💻 📖	Iiro Alhonen 📖	Mikhail Snetkov 💻	FritschAuctores 💻	rebos 💻	Leonard Ehrenfried 🚇 💻 ⚠️ 👀 📖
Nicolas Roelandt 📖 💻 ⚠️	Sacerdoss 📖	Tobias Wich 📖 💻	Alex Chaplianka 📖	Idris Hayward 📖	Karl von Randow 📖
Marco Lechner 📖	Mateusz Gaweł 💻	Nicolas Ternisien 📖	oschlueter 💻	Tim Nonner 💻	thlor 💻 📖
Yun Wang 📖 💻	Stefanic 💻 📖	xpoinsard 📖 💻	Bartizan 💻 📖 ⚠️	galewis2 💻	Derick M. 💻 📖 ⚠️
norcis 💻	SClo 💻 📖	Chris 💻 📖	iAlex97 💻 ⚠️	Mauricio Scheffer 💻	Sean Dean 📖
Philipp Gassmann 📖 💻 ⚠️	saddfox 📖 💻 ⚠️	gsg-git 📖	Stefan Breunig 💻	carlomion 💻 🚇	stouch 💻 📖 🚇
Sebastian Drozd 💻 📖	Ilia Lazebnik 💻	Denis Rykov 💻	Eric Hayter 📖	Anthony Fok 💻	Hari Teja 💻
onlygecko 💻

This project follows the all-contributors specification. Contributions of any kind welcome!