https://github.com/peter-evans/nominatim-docker

Docker image for Nominatim
https://github.com/peter-evans/nominatim-docker

docker-image geocoding nominatim nominatim-docker pbf reverse-geocoding

Last synced: 4 months ago
JSON representation

Docker image for Nominatim

• Host: GitHub
• URL: https://github.com/peter-evans/nominatim-docker
• Owner: peter-evans
• License: mit
• Created: 2017-08-10T12:05:00.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-03-29T00:14:55.000Z (almost 4 years ago)
• Last Synced: 2024-10-03T12:44:52.420Z (4 months ago)
• Topics: docker-image, geocoding, nominatim, nominatim-docker, pbf, reverse-geocoding
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/peterevans/nominatim/
• Size: 63.5 KB
• Stars: 30
• Watchers: 5
• Forks: 16
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# nominatim-docker

[![](https://images.microbadger.com/badges/image/peterevans/nominatim.svg)](https://microbadger.com/images/peterevans/nominatim)

[![CI](https://github.com/peter-evans/nominatim-docker/workflows/CI/badge.svg)](https://github.com/peter-evans/nominatim-docker/actions?query=workflow%3ACI)

Docker image for [Nominatim](https://github.com/openstreetmap/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*)](https://github.com/peter-evans/nominatim-docker/tree/v1.7.0/focal)

- [`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*)](https://github.com/peter-evans/nominatim-docker/tree/v1.7.0/bionic)

- [`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*)](https://github.com/peter-evans/nominatim-docker/tree/v1.7.0/xenial)

- [`1.6.2`, `1.6`, `latest`, `1.6.2-nominatim3.5.2`, `1.6-nominatim3.5.2`, `latest-nominatim3.5.2`  (*1.6/Dockerfile*)](https://github.com/peter-evans/nominatim-docker/tree/v1.6.2)

- [`1.6.1`, `1.6.1-nominatim3.5.1`, `1.6-nominatim3.5.1`, `latest-nominatim3.5.1`  (*1.6/Dockerfile*)](https://github.com/peter-evans/nominatim-docker/tree/v1.6.1)

- [`1.6.0`, `1.6.0-nominatim3.5.0`, `1.6-nominatim3.5.0`, `latest-nominatim3.5.0`  (*1.6/Dockerfile*)](https://github.com/peter-evans/nominatim-docker/tree/v1.6.0)

## Usage

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

```bash

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.

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

```

docker logs -f 

```

Then point your web browser to [http://localhost:8080/](http://localhost:8080/)

For documentation see [https://wiki.openstreetmap.org/wiki/Nominatim](https://wiki.openstreetmap.org/wiki/Nominatim)

## Persistent Storage

For a solution to persisting the database and immutable deployments check out [Nominatim for Kubernetes](https://github.com/peter-evans/nominatim-k8s).

## License

MIT License - see the [LICENSE](LICENSE) file for details