.. _Configurations: Configurations ============== There are several configuration files to take into account in a MapStore installation. They can be divided in two categories: - **Back-end configuration**: files that configure the Java Back-End of MapStore (proxy, database, ldap, logging...) - **Front-end configuration**: files to configure MapStore application (pages, plugins, map...) - **Printing module configuration** (optional): files to configure the printing module. Some of these configuration can be externalized from the ``webapp`` folder, to preserve them across application updates. :ref:`See the dedicated section for this ` .. todo:: the link doesn't work. .. note:: The separation between front end and back end configuration keeps the two parts independent, allowing to create MapStore projects with different back-ends. Back-end configuration ---------------------- Configuration files for Back-end are ``xml`` and ``properties`` files you can find in ``WEB-INF/classes`` directory. - ``proxy.properties``: configuration file for the internal proxy (useful for cross-origin requests). - ``geostore-datasource-ovr.properties``: configuration file for the database - ``log4j2.properties`` configuration for the logging. These files can be edited directly in the ``webapp`` folder or **externalized**, to preserve your changes across updates. .. note:: These files in the MapStore project folder will be copied by ``maven`` from ``web/src/main/resources`` directory into ``WEB-INF/classes``. So if a developer wants to customize them at build time, they can be copied from that position. Front-end configuration ----------------------- The front end configuration files consists in some JSON files that will be loaded via HTTP from the client. These JSON files are located in the ``configs`` directory of the webapp. - ``localConfig.json``: Defines the main application configuration, with all the general settings and the plugins for all the pages. `Details in official documentation `_ - ``pluginsConfig.json``: Configuration for the context editor. `Details in official documentation `__ - ``new.json``, ``config.json`` ... : Can be customized to set-up the initial **new** and **default** map, setting the backgrounds, initial position, scales etc... `Details in official documentation `__ You can find more information about how to configure these files checking .. note :: For version before 2021.02.xx, the configuration files was in the root directory .. todo:: Exercise: Edit plugins, and new.json (removing, or better adding, some backgrounds) Printing module configuration ----------------------------- If the **printing module** has been installed, in ``mapstore.war`` it can be configured by editing the files in ``printing``. This folder contains print plugin configuration and some additional resources related to print. In particular the file ``config.yaml`` contains all the configuration of the module, like: - allowed hosts/scales and resolutions - All the Print Layouts (A3, A4) You can edit this file to have your printing layouts and options. Because the mapstore printing module is an extension of the MapFish print (with some `additional features `_), you can find how to configure it directly on the official `MapFish print documentation `_. .. warning:: Because the printing module inherits from MapFish project, version 1.2, the position of this file can not be externalized without customizing the ``web.xml`` file.