⚙️ Georama Workflow Guide¶

This guide walks you through the full Georama publishing workflow — from preparing your QGIS project, configuring Georama, and integrating services, to publishing WMS and OGC API (WFS 3) layers.

🗺️ Overview¶

graph TB;
  prepareQGIS["Prepare QGIS Project with qgis-server-light"] -. "config.json" .-> configureGeorama
  configureGeorama["Configure Georama basics"] -."migrations & superuser".-> configureGeoramaUsers
  configureGeoramaUsers["Configure Georama users"] -."configure users & groups".-> configureGeoramaDataIntegration
  configureGeoramaDataIntegration["Configure Data integration"] -."configure projects & mandats".-> Publish
  Publish --> PublishWMS
  Publish --> PublishOGC

📁 QGIS Project Structure¶

Your QGIS projects have to be structured as follows and should be referenced in the .env file:

data/
├── project_one
│   ├── data
│   ├── project_one.json (generated by the CLI script)
│   ├── project_one.qgz
│   ├── project_one.xml
│   ├── print_templates
│   └── styles
└── forest_fires
    ├── data
    ├── forest_fires.json (generated by the CLI script)
    ├── forest_fires.qgz
    ├── forest_fires.xml
    ├── print_templates
    └── styles

🧰 Prepare the QGIS Projects¶

QGIS Server Light (QSL) offers a CLI script to extract the config JSON from QGIS Projects. It is available in the DEV version of the QSL docker image from the github container registry.

🔧 CLI Help¶

You can use that as follows:

docker run --rm ghcr.io/opengisch/qgis-server-light-dev:latest qgis_server_light.exporter.cli --help

The CLI script opens the stated QGIS project and uses pyqgis to extract the elements which are necessary to build the JSON. Therefore the data which is in the defined QGIS project has to be available (local files, databases etc.). In most cases the process will run without complaints, But if the data is not available for instance the bounding boxes cant be calculated and are default values which are not the right ones.

Info

QGIS project has to be available (local files, databases etc.)

Since the data is touched the process lasts a bit depending on the amount of layers you have in your project.

Info

Remark: Having spaces in the project file name is possible but not a good idea in general.

The JSON is written to stdout. To put it in a file the stdout has to be piped into an file.

🚀 Generate JSON¶

To generate

# update the container
docker pull ghcr.io/opengisch/qgis-server-light-dev:latest
# generate the JSON for Forest Fires project
docker run --rm -v $(pwd)/data:/io/data ghcr.io/opengisch/qgis-server-light-dev:latest qgis_server_light.exporter.cli --unify_layer_names_by_group True --project /io/data/forest_fires/forest_fires.qgz > data/forest_fires/forest_fires.json