A Docker image for the CLIFF geolocation software.
Note: CLAVIN, and by extension CLIFF, is very memory hungry due to the geonames index. To properly run, a minimum of 4GB of RAM is necessary. Any less and you'll experience errors.
This docker image uses a build and release workflow. The Lucene index is built
build_server image. The index is then copied to the host and can be
mounted as a volume to the actual CLIFF server container.
Build the index with:
This step builds the index and copies it to the host using the
HOST_INDEX_LOCATION variable. The default location is
Build the server with:
The CLIFF version is defined by
CLIFF_VERSION and defaults to
Run the server with:
This command mounts the index from the host to a Docker volume and starts the
container, running cliff on the port defined by
CLIFF_PORT. The default is
The API endpoint for CLIFF is
This pulls heavily from Andy Halterman's CLIFF-up Vagrant box. You can see his repo for more examples of how to make use of CLIFF.