Auto backup \2026-\04-\20

skills/selfhosted-map-tiles/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: selfhosted-map-tiles
+description: Self-hosted vector tile map services using GeoLibre and OpenFreeMap. Use when deploying map tile infrastructure, configuring basemaps for GIS applications, or troubleshooting map tile access from China (GFW issues). Covers Docker deployment, basemap configuration, and China-accessible alternatives.
+---
+
+# Self-Hosted Map Tiles
+
+GeoLibre + OpenFreeMap provide a self-hosted vector tile mapping stack based on OpenStreetMap data.
+
+## Quick Deploy
+
+```bash
+docker pull ghcr.io/opengeos/geolibre:latest
+docker run -d -p 8080:80 ghcr.io/opengeos/geolibre:latest
+```
+
+GeoLibre container includes a built-in Python sidecar and nginx reverse proxy serving everything on a unified domain. No additional CORS configuration is needed.
+
+## OpenFreeMap as Basemap
+
+GeoLibre ships with OpenFreeMap as a built-in basemap — works out of the box.
+
+- OpenFreeMap: free vector tile service based on OpenStreetMap
+- No registration, API key, or rate limits
+- Can be self-hosted or use the public instance
+- Self-hosting requires substantial disk space (global tiles ~hundreds of GB)
+
+### GFW Consideration
+
+OpenFreeMap's public instance is hosted in Hungary. Access from mainland China may be unstable due to the Great Firewall.
+
+### China-Accessible Alternatives
+
+When OpenFreeMap is not directly reachable, configure GeoLibre to use domestically available XYZ Tile basemaps:
+
+- **天地图** (Tianditu): China's national mapping service
+- **高德地图** (Amap/Gaode): Commercial map provider with tile access
+
+Replace the default tile source in GeoLibre configuration with one of the above. Both provide XYZ tile endpoints accessible within China without GFW issues.
+
+## Use Cases
+
+- Web GIS applications that need offline-capable or self-hosted basemaps
+- Applications serving Chinese users where foreign tile services are unreliable
+- Projects requiring no external API key or rate limit dependency