f2a1834 Sep 19, 2018
5 contributors

Users who have contributed to this file

@pcav @laurentj @rldhont @josemvm @Gustry
99 lines (73 sloc) 3.21 KB

Installing Lizmap


First you should install

  • The web server Apache or Nginx
  • The PHP-FPM package (php5-fpm or php7.0 on debian/ubuntu) or libapache2-mod-php (apache only). You can install PHP 5.6 or PHP 7.0/7.1/7.2. You can use generic package names, which will install latest version available (php5, php7.0 php7.2 etc.)
  • The package curl, and PHP extensions curl, sqlite3, gd and xml:
    • Debian 9 Stretch and Ubuntu 18.04: apt install curl php-sqlite3 php-gd php-xml php-curl
  • QGIS and its documentation about QGIS Server
  • (optional) PostgreSQL with PostGIS and its php extension (php-pgsql or equivalents)

Get the source

Download the Lizmap archive or get files from

Copy files to a directory for apache, let's say /var/www/mylizmap/.


Create lizmapConfig.ini.php, localconfig.ini.php and profiles.ini.php and edit them to set parameters specific to your installation. You can modify lizmapConfig.ini.php to set the url of qgis map server and other things, and profiles.ini.php to store data in a database other than an sqlite database.

cd lizmap/var/config
cp lizmapConfig.ini.php.dist lizmapConfig.ini.php
cp localconfig.ini.php.dist localconfig.ini.php
cp profiles.ini.php.dist profiles.ini.php

In case you want to enable the demo repositories, just add to localconfig.ini.php the following:


then exit the directory:

cd ../../..

Set rights for Apache, so php scripts could write some temporary files or do changes.

lizmap/install/ www-data www-data

Then you can launch the installer

php lizmap/install/installer.php


In your browser, launch:

In case you get a 500 - internal server error, run again:

cd /var/www/mylizmap/
lizmap/install/ www-data www-data

and eventually restart apache.

If you need to re-install lizmap on the same instance, you need to remove the file lizmap/var/config/installer.ini.php. This file is created by the installer.

Using QGIS composer/layouts and PDF in Lizmap

  • If you plan to print PDF from Lizmap, you need a fake X Server. See QGIS manual <>_ searching for xvfb. It works for Apache and NGINX


  • Check Lizmap settings
  • Check logs in Apache/Nginx and QGIS Server.
  • Enable logs in your lizmapConfig.ini.php with the line debugMode (Administration-->Lizmap configuration-->Services-->Debugging On)
  • Check lizmap/var/log (e.g. tail -f lizmap/var/log/messages.log). Check the addresses used, paste it in a browser, and check the error displayed.

You can enable the Jelix debug toolbar to get some information: In lizmap/var/config/localconfig.ini.php, add:

plugins = sqllog,sessiondata,defaultlog
defaultPosition = right

Documentation of Jelix toolbar: