geolens-io /geolens
Self-hosted geospatial data catalog with semantic search (pgvector), OGC/STAC APIs, and map builder. Built on FastAPI, PostGIS, React, and MapLibre.
★ 300⑂ 46👁 2⑃ 2,610● 1,275▤ 64
+0
Daily
300
stars
46
forks
2
watchers
2,610
prs
1,275
issues
64
releases
README
GeoLens
A self-hosted spatial data catalog and map builder that keeps track of where every dataset came from.
Live demo ·
Install ·
Documentation ·
Connect QGIS or code ·
Discussions
English · Español · Français · Deutsch · 简体中文
Manhattan's buildings at their surveyed roof heights, colored by construction era, with the subway network. Browse the demo's maps.
GeoLens is for teams whose spatial data is spread across file shares, PostGIS databases, web
services and STAC catalogs. It puts that data in one searchable catalog, records where each
dataset came from and checks whether the source is still current. Teams build and share maps in
the browser, and QGIS, scripts and AI agents read the same data through OGC API and STAC. It runs
on your own servers with Docker Compose, sends no telemetry and is licensed under Apache 2.0.
The demo needs no install or account; sign in with Google, GitHub
or Microsoft to use the map builder. Demo data may be wiped at any time.
A closer look
Search by meaning: "where storms hit the coast" finds hurricane tracks and coastal exposure layers.
Each dataset has a page with its metadata and source, plus a map preview when it has an extent.
Before you import a service layer, GeoLens previews its columns and first rows.
Each replacement is recorded in the history, and you can restore the previous version.
Layers render as points, symbols, heatmaps or clusters, and the ramp list can be limited to colorblind-safe ones.
3D terrain from your own elevation data, here the Matterhorn from swissALTI3D lidar.
Sentinel-2 scenes referenced from a STAC catalog. The imagery stays where it is and is tiled on request.
Keep a map to yourself, open it to your team, or make it public with a link and embed code.
The admin overview shows service health next to dataset and storage totals.
Viewer, editor and admin roles, with each capability switched on or off per role.
How it fits together
mermaid
flowchart LR
subgraph IN ["Bring data in"]
F["FilesGeoPackage · Shapefile · GeoParquetGeoTIFF · COPC · 3D Tiles"]
DB["Existing PostGIS tables"]
SVC["ServicesArcGIS · WFS · OGC API Features"]
ST["Remote STAC assets"]
end
subgraph GL ["GeoLens"]
CAT["Catalogsearch · metadata · provenance"]
MB["Map builderstyles · 3D · analysis · stories · dashboards · sharing"]
STD["Open APIsOGC API · STAC · DCAT · tiles"]
end
subgraph OUT ["Use it anywhere"]
WEB["Browsers and embeds"]
GIS["QGIS · ArcGIS · CesiumJS"]
CODE["curl · Python · TypeScript · DuckDB"]
AG["AI agents via MCP"]
end
F & DB & SVC & ST -- CAT
CAT -- MB -- WEB
CAT -- STD -- GIS & CODE & AG
One catalog for scattered data
- Upload Shapefile, GeoPackage, GeoJSON, GeoParquet, FlatGeobuf, KML/KMZ, zipped File
Geodatabase, CSV, Excel or GeoTIFF (converted tTop issues
#1203chore(titiler): CPL_VSIL_CURL_HEADER_FILE_KVP_ENABLED needs GDAL >= 3.13.2 — retarget onto a rasterio wheel bump7 comments · 2026-08-05#3167Story maps: chapters of text and images that move through map scenes4 comments · 2026-10-18#2547Make embedding model and width changes atomic and regenerate every tenant durably4 comments · 2026-10-01#3168Map dashboards: indicator, chart and selector widgets linked to a map3 comments · 2026-10-18#1836chore(frontend): eslint 10 migration blocked on eslint-plugin-jsx-a11y and eslint-plugin-react peers3 comments · 2026-09-04#711feat(backup): opt-in PITR profile — physical backup + WAL archiving for sub-24h RPO3 comments · 2026-07-26#3425Private STAC assets don't open in ArcGIS Pro2 comments · 2026-10-25#2884Publish desktop GIS maps into GeoLens (publish manifest v2: GeoLibre and QGIS)2 comments · 2026-10-11
Discussions
#3192[Q&A] Flexibility of the Geolens setup ?1 comments · 2026-10-19#2158Dataset Ownership & Granular Multi-User Editing Permissions in GIS1 comments · 2026-09-23#89Q&A - setup, OGC/STAC, search, and demo questions2 comments · 2026-05-04#88Roadmap feedback - what should v1.5 prioritize?0 comments · 2026-05-04#87Show and tell - what are you building with GeoLens?0 comments · 2026-05-04#86Welcome - introduce yourself and your use case0 comments · 2026-05-04
Latest release
v1.31.0 v1.31.0 2026-11-10An instance on 1.30.1 moves to 1.31.0 with one additive migration (0103, which allows the database source format), and releases back to 1.29.2 keep serving while it runs. SQL Server import stays off until an operator sets DATABASE_SOURCES. Overlays must declare EXTENSION_API_VERSION 23. Added - The aggregate endpoint takes blank_text_as_null for value_counts and group_by, counting a text column's empty strings with its NULLs. Dashboard widgets use it, so a category stored as both reads as one "(no value)" row. Whitespace-only text keeps its own key. - Database connections: an operator lists