Running from a Docker Image

You can run PhotoMapAI from a image registered with DockerHub. Alternatively, you can build and customize Docker image from PhotoMapAI's source code.

Running from DockerHub

There are two versions of PhotoMapAI available on DockerHub. The first, photomapai-demo is a demo version that comes prepackaged with a series of copyright-free images from Open Images. In this version, the ability to add, remove and edit albums has been disabled, as well as the ability to set the LocationIQ API key that is used to generate map thumbnails to display photograph GPS metadata. (Because LocationIQ grants licenses for personal use, this key cannot be incorporated into a public demo.)

The second image is photomapai. This is the full-featured version of the application, that comes without any pre-configured albums.

Assuming you have [Docker](https://docker.com installed on your system, run the following command to launch the demo version:

docker -p 8050:8050 lstein/photomapai-demo:latest

This will download the latest version of PhotoMapAI from DockerHub and run it, while mapping your desktop's network port 8050 to port 8050 running inside the container. You will see some startup messages. When they finish, point your browser to http://localhost:8050. You will see the PhotoMapAI user interface.

Running the full version is almost as easy:

docker -p 8050:8050 -v /path/to/my/pictures:/Pictures lstein/photomapai:latest

The additional -v option maps a folder on your desktop machine to the /Pictures folder in the container. Replace /path/to/my/pictures with the appropriate folder path on your system. You may provide multiple -v options to map more directories. Once PhotoMapAI is running, point your browser to http://localhost:8050 and proceed to define an album as described in Managing Albums.

You may find earlier versions of PhotoMapAI on DockerHub. Just do docker search photomapai to see all the available versions.

Building a Customized Docker Image

To build a customized image, you will need the PhotoMapAI source code. Download the zip or tar source code file from GitHub and unpack it. You will find two Docker build files in the docker folder, Dockerfile and Dockerfile.demo. The first builds the full application, and the second builds the demo version.

To build the full application, run this command from inside the root of the source code repository (the one with README.md):

docker build -f docker/Dockerfile -t photomapai

This will build the image and register it locally. You can then run it with docker -p 8050:8050 photomapai.

Building the demo version is almost the same, except that you have the option of preloading a collection of images for the demo. To do this, locate the (empty) demo_images folder in the source code repository, and copy a series of images into it. Then build the demo image with this command:

docker build -f docker/Dockerfile.demo -t photomapai-demo

The image will be built as before, but now you should see messages about loading and indexing the demo images.