Skip to content

Requirements

In this section you can have a glance of the minimum and recommended versions of the tools needed to build/debug/install MapStore

War Installation

You can download a java web container like Apache Tomcat from and Java JRE

Tool Link Minimum Recommended Maximum
Java link 81 11 112
Tomcat link 8.5 9 92

Debug / Build

These tools needs to be installed (other than Java in versions above above):

Tool Link Minimum Recommended Maximum
npm link 8 8 8.19.43
NodeJS link 16 16 16.20.13
Java (JDK) link 8 9 112
Maven link 3.1.0 3.6
python4 link 2.7.9 3.7

Notes

Here some notes about some requirements and reasons for max version indicated, for future improvements and maintenance :

  • 1 Java 8 is the minimum version required for running MapStore, but it is not compatible in case you want to use the print module. In this case, you need to use Java 11.
  • 2 About Java and Tomcat maximum versions:
    • For execution, MapStore is well tested on Java v11.
    • Build with success with v11, only smoke tests passing on v13, errors with v16.(Details on issue #6935)
    • Running with Tomcat 10 causes this issue #7524.
  • 3 About NodeJS and NPM:
    • note node 14.18.1 / npm 6.14.15 causes this issue on MapStore project system.
    • Node 18 causes webpack issue needs to be solved by changing the hash algorithm or setting proper flags.
    • If you are using Node >= 12 you can remove the -max_old_space_size=2048 config for the compile script
  • 4 Python is only needed for building documentation.

Running in Production

System requirements

Resource Minimum Recommended
Processor 2 Core 2 Core
Memory 2 GB 4 GB

Database

In production a PostgreSQL database is recommended:

Tool Link Minimum Recommended Maximum
Postgres link 9.6 13 13