Configuration#
Settings are read from environment variables with the OWRT_ prefix or from an ignored
.env file in the working directory (.env.example is a starting point). The same settings
apply to the service, the CLI, the Python loader and dataset generation.
Setting |
Default |
Purpose |
|---|---|---|
|
|
Bind address of the service |
|
|
Port of the service |
|
|
Search provider name reported by |
|
|
Lifetime of cached Nominatim, Overpass and Overture building responses |
|
|
Building limit for simulations and scene compilation |
|
|
Building limit for browsing |
|
|
Building sources eligible for automatic routing, as a JSON list |
|
unset |
Local Boston catalog for offline or historical releases |
|
|
Antenna sources eligible for automatic routing, as a JSON list |
|
unset |
OpenCelliD API token for the export download; never recorded |
|
unset |
GeoJSON or CSV file of the |
|
|
Snapshots of antenna sources, relative to the checkout |
|
|
Overture surface features per theme |
|
|
Provider HTTP timeout |
|
|
Overture connect timeout |
|
|
Overture request timeout |
|
project string |
Sent to Nominatim and Overpass |
|
public Overpass |
Overpass endpoint; deploy a private instance for sustained use |
|
public Nominatim |
Search endpoint |
|
|
Output root for datasets |
|
|
Cache root of compiled scenes, shared by the loader and the service, relative to the checkout |
|
|
Cached Overture STAC index per release |
|
unset |
Directory of further engine specification files for the engine registry |
Script-level variables that are not settings: OWRT_RELOAD=1 enables auto-reload in
scripts/run.sh; OWRT_BIND_ADDRESS changes the host interface in Compose;
OWRT_EXAMPLE_* configure examples/generate_dataset.py; OWRT_LOCAL_BUILDINGS is read
by the example building-source plugin.
Overture, OpenStreetMap, Overpass and Nominatim are public remote services with no guaranteed capacity. Nominatim allows one request per second and its results must be cached, and the OSM tile service is for interactive use only. Production deployments should configure suitable provider capacity and keep attribution visible.