Configuration of VTS-Mapproxy is saved in simple text file, using INI file format. You can get exhaustive list of configuration options, by running mapproxy --help-all command in the command line. Here we describe the most important options you may want to tweak.
The best starting point for configuring mapproxy on your own is a fully commented configuration file used in VTS Backend.
Mapproxy configuration options¶
[log] section, you can define where and how the server logs will be
stored. Two important options you can set are
- file configuration option should be path, where the logfile is stored.
This option set’s the verbosity level of VTS-Mapproxy. It consists from Info, Error, Warning (and Debug) triplet (with the Debug option, it’s of course quadruplet). You for each option, you can also define verbosity level using numbers 1-4. For example, the default verbosity configuration is set as Info to level 3 and Warning together with Error options to level nr. 2:
It might look a bit complicated, therefore, you can also use one of the pre-defined keywords, which do already have the levels set:
ALL- I1E1W1DD (here we use the
DDoption for debug messages)
- Path where extra resource metadata are stored once the resource is sucessfully loaded for the first time.
[http] section, the HTTP server options are configured, like:
- The TCP endpoint, where to listen at, e.g.
0.0.0.0:3070(the default value), possible formats are
- Number of parallel HTTP threads, defaults to number of CPU cores.
true, direct listing and browsing of published resources is possible and
introspectionsection in resource definitions takes effect. Not recommended for production.
URL of this server’s root directory. Defaults to http://ip:port/ or http://localhost:port/, based on the value of
listen. Used only in cases when full URL is needed:
- documentation (various README files)
WMTSCapabilities.xmlfile which (unfortunately) requires absolute addresses
- in control interface used by
Here is defined, how you configure you data resources with following options:
- Resource configuration type, is either
- Root path of datasets defined as relative path.
type there is one more parameter.
- resource backend conffile: configuration file-based resource backend:
patharg Path to resource file (JSON).
- resource backend python: mysql-based resource backend:
scriptarg Path pythong script. It must privide global function run().
Resources configuration reference can be found in vts-mapproxy repository on GitHub.
Settings pertaining to internal GDAL operations:
- Number of parallel GDAL processes, defaults to number of CPU cores.
core.threadCountshould be same or higher than this.
- Real memory limit of all GDAL processes (in MB). Directly influences memory footprint of whole mapproxy, should be adjusted with respect of available memory. Low values may slow mapproxy down (it will repetitively kill large GDAL processes).