Skip to content

docs(upgrade): Add documentation on upgrade and qgis-plugin update #83

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs(upgrade): Add documentation on upgrade and qgis-plugin update #83

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,56 @@ You need to :
* in the Lizmap admin panel, add the directory you created
* add one or more QGIS projects with the Lizmap CFG file in the directory

## Update versions

To update versions simply update your `.env` file.

```bash
LIZMAP_VERSION_TAG=3.8
QGIS_VERSION_TAG=3.40
POSTGIS_VERSION=13-3
```

Find the **list of available docker images versions** available, in the Docker Hub tag page of each image :

| Image name | Dockerhub image | Env variable related |
| ------------ | ------ | ---- |
| **3liz/lizmap-web-client** | [hub.docker.com/r/3liz/lizmap-web-client](https://hub.docker.com/r/3liz/lizmap-web-client/tags) | `LIZMAP_VERSION_TAG` |
| **3liz/qgis-map-server** | [hub.docker.com/r/3liz/qgis-map-server](https://hub.docker.com/r/3liz/qgis-map-server/tags) | `QGIS_VERSION_TAG` |
| **3liz/postgis** | [hub.docker.com/r/3liz/postgis](https://hub.docker.com/r/3liz/postgis/tags) | `POSTGIS_VERSION` |

Once updated, simply **run the following command**

``` bash
docker compose up -d
```

This one will **pull the new images**, and update your instance versions.

#### *NB :* You might face `The lizmap_server plugin needs to be updated` error (see [#68](https://github.com/3liz/lizmap-docker-compose/issues/68))

To fix this issue :
1. Connect to your lizmap container.
``` bash
docker compose exec map bash
Copy link
Contributor

@Gustry Gustry Jul 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
docker compose exec map bash
docker compose exec map /src/install-lizmap-plugin.sh
docker compose restart map

See my comment in the issue #68 if this can be simplified. Doing multiple commands using exec is not convenient.

Or even from your host

./configure.sh configure

which is already in the readme.

```

2. Move to your qgis server plugins folder
``` bash
cd /srv/plugins
qgis-plugin-manager list
qgis-plugin-manager update
qgis-plugin-manager upgrade
```

More info about qgis-plugin-manager [here](https://github.com/3liz/qgis-plugin-manager)

3. Exit from your container and restart lizmap container to handle new changes
``` bash
exit
docker compose restart map
```

## Reset the configuration

In command line
Expand Down