lizmap-documentation icon indicating copy to clipboard operation
lizmap-documentation copied to clipboard

Update Lizmap from 3.8 to 3.9

Open katagen opened this issue 5 months ago • 8 comments

I have an instance of Lizmap 3.8 that works perfectly. To be honest, I'm a bit afraid to "jump" in 3.9, due to the fact that I need Py-QGIS Server.

The documentation is not clear at all, how to upgrade from 3.8 to 3.9. It only explains how to install a new instance, not how to update!

katagen avatar Jul 12 '25 17:07 katagen

Updating Lizmap did not change with 3.9 (so it's the same as going from 3.8.8 to 3.8.9 for example) and if you really want, you can use 3.9 without py-qgis-server by changing/adding the block in your lizmap/var/config/localconfig.ini.php to:

[qgisWrapper] ; If off, FCGI is not allowed, only Py-QGIS-Server or QJazz ; https://docs.lizmap.com/current/en/install/py-qgis-server.html ; https://docs.3liz.org/py-qgis-server/ ; https://github.com/3liz/qjazz allowFcgi=on

But if you want to dig in deeper why py-qgis-server is highly recommended:

https://github.com/3liz/lizmap-web-client/issues/5567

Long Story short: it's faster and scales up with your hardware by enabling multi-threading, which qgis-server with apache2/nginx can't really do.

Upgrading your qgis-server to py-qgis-server should be no problem, basically you install the python wrapper, create those files mentioned in the documentation and change in your LWC the entry-points/api url to use py-qgis-server. this should not really touch your existing set-up, so in case things go south you can simply change LWC to use pure qgis server again (@gustry correct me if i'm wrong :) )

For transparency, i created a whole new server, installed py-qgis-server there, moved my LWC data and instances over to the new server - so i did not really do the upgrade-qgis-serer-to-py-qgis-server thing! :D

meyerlor avatar Jul 13 '25 17:07 meyerlor

First install and use Py-QGIS-Server on your 3.8 instance, can you try ? Then, when your 3.8 instance is up and running with Py-QGIS-Server, you can migrate to 3.9 indeed.

Gustry avatar Jul 15 '25 13:07 Gustry

No, I have a 3.8 instance without py-qgis. I don't no how to update to 3.9, because there is no description for that... there is only a documentation to install 3.9 from zero!

katagen avatar Jul 15 '25 20:07 katagen

This upgrade documentation is valid since 3.5: https://docs.lizmap.com/current/en/install/upgrade.html

meyerlor avatar Jul 15 '25 20:07 meyerlor

First install and use Py-QGIS-Server on your 3.8 instance, can you try ?

No, I have a 3.8 instance without py-qgis.

Yes, I was proposing you to install Py-QGIS-Server on your 3.8 instances.

Gustry avatar Jul 16 '25 06:07 Gustry

But in the release file of 3.9.0, it is written "Py-QGIS-Server is now required by default".

So I can use it without py-qgis or not?

As I said, it is really unclear!

As long it is not more explain, how to install... I won't use it! How to use a specific domain name, how to secure (https) and so on... on the web, we find a lot of things to manage that for nginx or apache, but for py-qgis, it is really poor!

katagen avatar Jul 18 '25 21:07 katagen

But in the release file of 3.9.0, it is written "Py-QGIS-Server is now required by default".

So I can use it without py-qgis or not?

"By default" means you can still use QGIS Server with Apache or Nginx, but with a configuration to change. See the Note in https://docs.lizmap.com/current/en/install/pre_requirements.html with claims We recommend installing Py-QGIS-Server <py-qgis-server>_ to manage QGIS Server processes. If so, you do not need to configure Apache/Nginx for QGIS Server

As I said, it is really unclear!

Documentation is not an easy task. As soon as your problem is solved, and you understand better how to install, you could help future users by contributing in https://github.com/3liz/lizmap-documentation .

As long it is not more explain, how to install... I won't use it!

Nobody forces you to. Please keep a kindly tone in this discussion. We are willing to help.

How to use a specific domain name, how to secure (https) and so on... on the web, we find a lot of things to manage that for nginx or apache, but for py-qgis, it is really poor!

The documentation states that we now strongly advise to use Py-QGIS-Server to run QGIS Server (not Apache or Nginx anymore). Lizmap Web Client, on the other side, is a PHP application which needs to be behing a Web server, so you still need to configure Apache or Nginx to server your Lizmap Web Client application.

mdouchin avatar Jul 21 '25 07:07 mdouchin

But in the release file of 3.9.0, it is written "Py-QGIS-Server is now required by default".

So I can use it without py-qgis or not?

Indeed, with the "default" configuration, Py-QGIS-Server is required, but, if you really don't want Py-QGIS-Server, you can decide to not use it, please read the message from @meyerlor to you, he was explaining you how to bypass : https://github.com/3liz/lizmap-documentation/issues/280#issuecomment-3067175849

How to use a specific domain name, how to secure (https) and so on... on the web, we find a lot of things to manage that for nginx or apache, but for py-qgis, it is really poor!

As @mdouchin said, configuring HTTPS, specific domain name and so one is not related to Py-QGIS-Server, you do need tweak this. It won't change anything to your Apache/Nginx configuration.

Py-QGIS-Server is only related to QGIS-Server.

As said earlier, did you try the installation of Py-QGIS-Server ? https://docs.lizmap.com/current/en/install/py-qgis-server.html

Gustry avatar Jul 21 '25 07:07 Gustry