onezoom/oztree repository overview

The One Zoom tree of life explorer provides an easy way to navigate the evolutionary tree that connects all living things. It is a product of the OneZoom not for profit organisation registered in the UK. Our mission is to advance the education of the public in the subjects of evolution, biodiversity and conservation of the variety of life on earth.

Except for image thumbnails, which are dynamically served from the OneZoom website, this docker image contains everything necessary to run a stand-alone version of the One Zoom website (www.onezoom.org⁠, see also our code repository at https://github.com/OneZoom/OZtree⁠). Please note that the image contains both OneZoom software (use of which is subject to the One Zoom license https://www.onezoom.org/OZtree/static/downloads/OneZoom_License_V1.pdf⁠) and third party data sources (please see https://www.onezoom.org/data_sources.html⁠ for more information).

⁠Running the image

You can run OneZoom to view on port 8080 (http://127.0.0.1:8080⁠) using:

docker run -p 8080:80 --name running_onezoom onezoom/oztree

This may take a while (many minutes) to get going, because we are not allowed to package the IUCN data in this docker image (this would also risk packaging information which would become out of date). Therefore, when this image is run, it waits for the web server to be set up, then downloads the IUCN data from http://apiv3.iucnredlist.org/⁠. This can take about 15 minutes and makes several large requests to the IUCN server (outputting console information as it does so).

⁠Saving the image

It can be tedious and unnecessary to have to re-download the IUCN data if you are regularly starting and stopping this image. To avoid this, once the IUCN processing has finished (when "IUCN DONE!" is output to the console), you can commit a new image using:

docker commit --change="CMD /sbin/my_init" running_onezoom onezoom/oztree-with-iucn then in future you can launch that image using

docker run -p 8080:80 onezoom/oztree-with-iucn

which will run OneZoom on port 8080, without re-populating the IUCN data.

⁠Using your own photos

To create a version of OneZoom with your own images, see these instructions⁠.