Docker
======

MapStore has a set docker image for each release available `on Docker hub <https://hub.docker.com/r/geosolutionsit/mapstore2/tags?page=1&ordering=last_updated>`__

You can simply run this instance by pulling and running the container.

.. code-block:: bash

  docker pull geosolutionsit/mapstore2
  docker run  --name mapstore geosolutionsit/mapstore2 # named MapStore.

The docker image are configured to use H2 local database.

In order to have a production instance of MapStore using docker, you need at least to externalize the database and connect to an instance of PostgreSQL.


Externalize the database configuration
--------------------------------------

First of all, you have to download the image

.. code-block:: bash

  docker pull geosolutionsit/mapstore2

Then you have to create on your host machine a file with the database connection settings.
Let's create this file in ``/docker/geostore-datasource-ovr-postgres.properties``.

.. code-block:: properties

  # Setup driver and dialect for PostgreSQL database
  geostoreDataSource.driverClassName=org.postgresql.Driver
  geostoreVendorAdapter.databasePlatform=org.hibernate.dialect.PostgreSQLDialect

  # Connection parameters
  geostoreDataSource.url=jdbc:postgresql://192.168.1.100:5432/geostore
  geostoreDataSource.username=geostore
  geostoreDataSource.password=geostore
  geostoreEntityManagerFactory.jpaPropertyMap[hibernate.default_schema]=geostore

  # Automatic create-update database mode
  geostoreEntityManagerFactory.jpaPropertyMap[hibernate.hbm2ddl.auto]=validate

  # Other options
  geostoreVendorAdapter.generateDdl=true
  geostoreVendorAdapter.showSql=false

.. note::
  Is up to you to create a proper postgreSQL instance (docker or not) and make it reachable from the docker instance at the address written in DB.
  Follow the guide in :ref:`database section <Database>` for this.

As a final step you have to
the docker instance of MapStore with the options for:

- adding the proper JAVA_OPTS to the JVM to externalize the database configuration
- mapping the configuration file with the file on the host machine you created before.

.. code-block:: bash

  docker run \
    -v `pwd`/docker/geostore-datasource-ovr-postgres.properties:/usr/local/tomcat/conf/geostore-datasource-ovr.properties \
    -e JAVA_OPTS="-Xms512m -Xmx512m -XX:MaxPermSize=128m -Dgeostore-ovr=file:///usr/local/tomcat/conf/geostore-datasource-ovr.properties" \
    --name mapstore \
    -p8080:8080 \
  geosolutionsit/mapstore2

Doing so, the mapstore instance will run on port 8080.

.. note :: Future versions of MapStore will provide a ``docker-compose`` file to have postgreSQL docker image properly configured.