Configuration Model
Two Layers of Configuration
The service intentionally separates configuration into:
- startup defaults from environment variables
- persisted runtime configuration in
/data/server_config.json
At runtime, the persisted configuration wins when present.
Main Runtime Settings
| Key | Meaning |
|---|---|
min_colormap_classes | lower bound for generated color classes |
max_upload_mb | upload size limit |
max_parallel | concurrency hint used by the UI and some processing flows |
wms_debug | verbose WMS debugging |
wms_use_mapcache | use MapCache first for GetMap |
point_query_public | make point query features public |
mapcache_seed_minzoom / maxzoom | seed zoom range |
mapcache_seed_workers | parallel seed workers |
mapcache_seed_on_ingest | automatic seeding after ingest |
mapcache_seed_max_tiles | cap tiles per seed job |
mapcache_request_timeout | timeout for MapCache source fetches |
mapcache_public_url | public MapCache URL for clients |
hyspex_parent_scan_multiplier | scan expansion factor for parent ingestion |
hyspex_parent_scan_limit | maximum CSW scan size |
csw_filename_prefix_mode | naming convention for CSW-backed files |
thumbnail_cache_mode / dir / max | thumbnail cache behavior |
netcdf_cache_max | in-memory NetCDF cache size |
Main Environment Variables
In addition to the runtime keys above, the current stack also depends on:
DATA_ROOTWMS_PUBLIC_URLMAPCACHE_INTERNAL_URLMAPCACHE_CACHE_DIRCELERY_BROKER_URLCELERY_RESULT_BACKENDAUTH_HASH_SALTMAGO_TERRAIN_PUBLIC_URLHYSPEX_LOCAL_ROOTHYSPEX_OPENDAP_STRIP_PREFIX
Where Configuration Is Changed
| Surface | Use |
|---|---|
/config GET | inspect the effective runtime config |
/config POST | persist changes |
/ui/ server config card | operator-friendly config editing |
| stack files | bootstrap environment defaults and safe startup overrides |
Important Behavior
Because server_config.json overrides the environment, stack files in this repository deliberately write safe persisted defaults at startup in the local swarm profile. That prevents old experiments from re-enabling aggressive options such as large cache seeding or stale debug settings.