DEPRECATED: Docker build files have been moved to the py-qgis-server repository

This repository will build images only up to 1.2.x versions

Qgis 3 map server

Setup a OGC WWS/WFS/WCS service.

Run the python qgis server from https://github.com/3liz/py-qgis-server in a docker container.

Run example

docker run -p 8080:8080 \
       -v /path/to/qgis/projects:/projects \
       -e QGSRV_SERVER_WORKERS=2 \
       -e QGSRV_LOGGING_LEVEL=DEBUG  \
       -e QGSRV_CACHE_ROOTDIR=/projects \
       -e QGSRV_CACHE_SIZE=10 \
       3liz/qgis-map-server

Requests to OWS services

The OWS requests use the following format: /ows/?<ows_query_params>

Example:

http://myserver:8080/ows/?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetCapabilities

Passing MAP arguments

MAP arguments are treated as relative to the location given by QYWPS_CACHE_ROOTDIR

Configuration

The server is configured via environment variables or configuration file as described here

Running the server as specific user

By default, the server ren as user and group id 9001. The user id may be customized by setting the QGSRV_USER environment variable to the - numerical - user ID of your choice

Qgis project Cache configuration

QGSRV_CACHE_ROOTDIR: Absolute path to the qgis projects root directory
QGSRV_CACHE_SIZE: Qgis projects cache size
QGSRV_LOGGING_LEVEL: Logging level (DEBUG,INFO)
QGSRV_SERVER_WORKERS: Number of qgis server instances

The cache hold projects, if the project timestamp change on disk then the project will be reloaded.

Xvfb and Display support

Xvfb display support can be activate with QGSRV_DISPLAY_XVFB=ON which is the default behavior.

Plugin path

Plugins can be used from a host mounted volume; use the QGSRV_SERVER_PLUGINPATH environment variables to set the path inside the container.

Pass QGIS environment variables

You may pass QGIS server environment variables by defining them as docker environment variables.

Useful variables are:

QGIS_OPTIONS_PATH              # Path to look for qgis settings ini file
QGIS_SERVER_PARALLEL_RENDERING # Enable/Disable QGIS_SERVER_PARALLEL_RENDERING (default to false)
QGIS_SERVER_MAX_THREADS        # Max num rendering threads (per processes) - default unlimited
QGIS_SERVER_WMS_MAX_HEIGHT     # Maximum height for a WMS request - default not set
QGIS_SERVER_WMS_MAX_WIDTH      # Maximum width for a WMS request  - default not set

Using with lizmap

In order to use the server with lizmap, you must set the following configuration in your lizmapConfig.ini.php:

[services]
wmsServerURL="http://my.domain:<port>/ows/"
...

; Use relative path
relativeWMSPath=true

Notes

GeoPackages is not multiprocessing friendly and are not working well with read-only volumes: avoid them if you if you intend to use your data with read-only volumes.

3liz / docker-qgis-server

readme