tonsnoei / photon-docker

The photon geocoder for docker

Have your own geocoder up and running within the hour, you will require about 60GB of disk space and has no further dependencies. If you select a specific country, you can reduce the necessary disk space.

Feel free to fork and improve.

See this blog post for more info.

Run

The image itself is pretty small, the first time the container is executed, a 60GB searchindex will be downloaded. The blog post explains how to use only a specific country or region.

The data volume is exposed as /photon/photon_data and can be mounted, this way you'll only have to download the data once.

With docker run

docker run -p 2322:2322 -it tonsnoei/photon-geocoder:latest

Search

http://localhost:2322/api?q=amsterdam

For more details on the API check the Photon github repository.

Build from git

https://github.com/tonsnoei/photon-docker

With docker-compose

docker-compose build #optional
docker-compose up

Note: if you abort the download, you have to remove the volume photon_data before restarting the container

FAQ

• How do I pass arguments to the photon.jar ?

  The entrypoint accepts arguments for the photon.jar, you can invoke it by using docker exec

• Do I need to have nominatim ?

  The container downloads the latest prebuilt search index, there is no immediate need to have nominatim installed.

• What is Photon ?

  Photon is a geocoder, check out their website and their github repository