Requirements before installing Lizmap Web Client

Note

If you want to quickly install and test Lizmap Web Client in a few steps, you can follow those instructions.

QGIS Server

Warning

Before installing the QGIS Server part, it is very highly recommended to use the same version between QGIS Desktop and QGIS Server.

Even if some functions might work, there is a probability that some configuration won’t work if these two versions are different.

The reason is QGIS Server version X might not be able to a QGIS project made with a QGIS Desktop version Y.

Follow the QGIS Documentation how to install QGIS Server : https://docs.qgis.org/latest/en/docs/server_manual/

Using a webserver (Apache or Nginx), you must install QGIS Server. With Nginx, the preferred way is to use spawn-fcgi. Do not use the fcgiwrap, this solution is not efficient.

In the Nginx configuration, it’s good to use the QGIS_OPTIONS_PATH variable for a folder with write permissions for www-data. These is explained in the QGIS Server documentation.

You should also install and configure XVFB mentioned in the QGIS Documentation. This is useful for printing PDF. You can only skip this section if you don’t plan to print PDF on the server side.

After you have setup your web server with QGIS-Server, check that the URL of QGIS Server is working. You probably get a XML like:

<ServerException>Project file error</ServerException>

Keep this URL, we will use it later in the Lizmap admin panel.

QGIS Server plugins

Some plugins can be added to QGIS Server. This will enable some features in Lizmap. It’s not compulsory but in some situations, it’s better.

Either you should setup the QGIS_PLUGIN_PATH environment variable during the installation of QGIS Server or use the default one provided by QGIS. https://docs.qgis.org/latest/en/docs/server_manual/config.html#environment-variables