Installation of map.apps

Prerequisites

Ensure that the following software is installed on your system before proceeding with the installation of map.apps. Compatible versions can be found in the System Requirements.

  • Java: For example, from the OpenJDK download page .

  • Apache Tomcat: Available at the Apache Tomcat download page . For a Windows installation, the "32-bit/64-bit Windows Service Installer" is recommended.

    • Additional installation details can be found in the Tomcat setup documentation .

    • If your system environment requires specific proxy server settings, configure them in Tomcat.

  • Database:

    • A local HSQL database is created by default for testing purposes.

    • For production environments, install and configure a dedicated database. Details can be found in Database Configuration.

Installation Steps

This guide describes the initial installation of map.apps. For instructions on updating an existing installation, refer to Updating an Existing Installation.

Follow these steps to install map.apps:

  1. Unpack the WAR file: Copy the mapapps.war file from the map.apps delivery directory to a temporary directory and extract it there.

  2. Set the data directory: Modify the data.directory.location parameter in the WEB-INF\classes\custom-application.properties file if you want to change the default data directory \${user.home}\.mapapps. The placeholder user.home refers to the home directory of the user running Tomcat.

  3. Copy configuration files: Copy the application.properties and secrets.properties files from the WEB-INF\classes\config-templates directory to the data directory defined in step 2.

  4. Set the administration password: Open the <data.directory.location>\secrets.properties file and set a password for the secret.admin.pw parameter.

  5. Deploy the web application: Copy the modified directory from step 1 (or the modified WAR file) to the %TOMCAT%\webapps folder. Alternatively, you can use the Tomcat Manager (commonly available at http://<yourserver>:8080/manager/html) to deploy the WAR file.

  6. Start the Tomcat service: Restart the Tomcat service to apply the changes.

Additional configuration steps are required to set up map.apps for production use. Refer to Configuration and Authentication for details.

The web application is now accessible at https://<yourserver>/mapapps and displays an empty app overview:

empty app overview

To create your first app, refer to the guide at Getting Started.