zearthur99/nominatim-docker

Docker image for Nominatim

nominatim-docker

Docker image for Nominatim, an open source tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding).

Supported tags and respective Dockerfile links

• 1.7.0-focal, 1.7-focal, 1-focal, latest-focal, 1.7.0-focal-nominatim3.5.2, 1.7-focal-nominatim3.5.2, 1-focal-nominatim3.5.2, latest-focal-nominatim3.5.2 (1.7/Dockerfile)

• 1.7.0-bionic, 1.7-bionic, 1-bionic, latest-bionic, 1.7.0-bionic-nominatim3.5.2, 1.7-bionic-nominatim3.5.2, 1-bionic-nominatim3.5.2, latest-bionic-nominatim3.5.2 (1.7/Dockerfile)

• 1.7.0-xenial, 1.7-xenial, 1-xenial, latest-xenial, 1.7.0-xenial-nominatim3.5.2, 1.7-xenial-nominatim3.5.2, 1-xenial-nominatim3.5.2, latest-xenial-nominatim3.5.2 (1.7/Dockerfile)

• 1.6.2, 1.6, latest, 1.6.2-nominatim3.5.2, 1.6-nominatim3.5.2, latest-nominatim3.5.2 (1.6/Dockerfile)

• 1.6.1, 1.6.1-nominatim3.5.1, 1.6-nominatim3.5.1, latest-nominatim3.5.1 (1.6/Dockerfile)

• 1.6.0, 1.6.0-nominatim3.5.0, 1.6-nominatim3.5.0, latest-nominatim3.5.0 (1.6/Dockerfile)

Usage

Pass the NOMINATIM_PBF_URL environment variable to the container referencing the URL of your PBF file:

docker run -d -p 8080:8080 \
-e NOMINATIM_PBF_URL='http://download.geofabrik.de/asia/maldives-latest.osm.pbf' \
--name nominatim peterevans/nominatim:latest

The PBF file will be downloaded and the database will begin building. Note that very large databases may take hours to be built.

Alternatively, you can mount a volume to /nominatimdata and specify the NOMINATIM_PBF_FILE_NAME environment variable.

docker run -d -p 8080:8080 \
-v /home/me/nominatimdata:/nominatimdata \
-e NOMINATIM_PBF_FILE_NAME=data.osm.pbf \
--name nominatim peterevans/nominatim:latest

Tail the logs to verify the database has been built and Apache is serving requests:

docker logs -f <CONTAINER ID>

Then point your web browser to http://localhost:8080/

For documentation see https://wiki.openstreetmap.org/wiki/Nominatim

Persistent Storage

For a solution to persisting the database and immutable deployments check out Nominatim for Kubernetes.

License

MIT License - see the LICENSE file for details