selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

QGIS Web Client logo

Self-host QGIS Web Client

v2026.0.30-lts

Modular web GIS client for QGIS Server

ReleaseOpen SourceBSD-2-Clause
Updated13 hours ago
LanguageJavaScript
Setup difficultyAdvanced
MobileResponsive
Stars
383
Port
80 (Main application (API gateway))
Requires
Nginx, PostgreSQL/PostGIS, QGIS Server, Solr
Docker
sourcepole/qwc-map-viewer
Install with Docker Compose
QWC main map interfaceResponsive QWC web map interface on desktop and mobileTheme switcher for thematic map viewsMap and layer tree interfaceFeature and map information panelDrawing and redlining toolsMeasurement and height profile toolsUnified search interface and resultsQGIS feature search formMap filter interface

What is QGIS Web Client?

Should you self-host QGIS Web Client?

QGIS Web Client scores 57/100 on selfhost.directory (how scoring works) and ranks #9 of 12 in Maps. It has 383 GitHub stars.

It shipped 10 stable releases in the past year. The latest, ci-latest-master, came out on 27 October 2026.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is BSD-2-Clause-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is GeoServer (71/100, 4 484 stars). It scores higher overall, so compare the two before you pick. See QGIS Web Client vs GeoServer side by side.

Features

  • Batch/atlas printing
  • Drawing and measurement tools
  • External layer import
  • Feature identification
  • Feature reports
  • Layer control
  • Map and data export
  • Map filtering
  • Map printing
  • QGIS feature search
  • Routing and isochrones
  • Sensor data integration
  • Temporal data visualization
  • Thematic map views
  • Unified full-text search

QGIS Web Client README

How to install QGIS Web Client

Install QGIS Web Client with Docker Compose

Docker and docker-compose
Environment variables
JWT_SECRET_KEY, POSTGRES_PASSWORD, SERVICE_UID, SERVICE_GID, TOTP_ENABLED, DEFAULT_LOCALE, MAIL_SUPPRESS_SEND, GROUP_REGISTRATION_ENABLED

git clone --recursive https://github.com/qwc-services/qwc-docker.git cd qwc-docker cp docker-compose-example.yml docker-compose.yml cp api-gateway/nginx-example.conf api-gateway/nginx.conf

Set POSTGRES_PASSWORD in docker-compose.yml

python3 -c 'import secrets; print("JWT_SECRET_KEY="%s"" % secrets.token_hex(48))' >.env

Set SERVICE_UID and SERVICE_GID in docker-compose.yml

sudo chown 8983:8983 volumes/solr/data docker compose up

Runs full qwc-services stack with authentication, editing, search, printing, and more. Map viewer at http://localhost:8088/

How to configure QGIS Web Client

  • DEFAULT_LOCALEenDefault UI locale

    Default UI locale

  • GROUP_REGISTRATION_ENABLEDTrueEnable group registration

    Enable group registration

    values: True, False

  • JWT_SECRET_KEYSecret key for JWT token signing

    Secret key for JWT token signing

  • LDAPLDAP authentication configuration

    LDAP authentication configuration

  • MAIL_SUPPRESS_SENDTrueSuppress sending emails (for development)

    Suppress sending emails (for development)

    values: True, False

  • OIDCOpenID Connect authentication configuration

    OpenID Connect authentication configuration

  • POSTGRES_PASSWORDPostgreSQL superuser password

    PostgreSQL superuser password

  • SERVICE_GIDGID for service processes to match host volume ownership

    GID for service processes to match host volume ownership

  • SERVICE_UIDUID for service processes to match host volume ownership

    UID for service processes to match host volume ownership

  • TOTP_ENABLEDFalseEnable TOTP two-factor authentication

    Enable TOTP two-factor authentication

    values: True, False

QGIS Web Client releases & version history

FAQ

How do I change the qwc-docker port?

Modify the api-gateway port mapping in docker-compose.yml, for example to run on port 1234 instead of the default 8088.

More in Maps

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…