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

OWRT_HOST

127.0.0.1

Bind address of the service

OWRT_PORT

8765

Port of the service

OWRT_LOCATION_PROVIDER

osm_nominatim

Search provider name reported by /api/health; search uses Nominatim

OWRT_CACHE_TTL_SECONDS

900

Lifetime of cached Nominatim, Overpass and Overture building responses

OWRT_MAX_BUILDINGS

5000

Building limit for simulations and scene compilation

OWRT_MAX_VIEW_BUILDINGS

7500

Building limit for browsing

OWRT_AUTOMATIC_BUILDING_SOURCES

["3dbag", "berlin"]

Building sources eligible for automatic routing, as a JSON list

OWRT_BOSTON_SOURCE_CATALOG

unset

Local Boston catalog for offline or historical releases

OWRT_AUTOMATIC_ANTENNA_SOURCES

["anfr", "antennebureau", "uke", "opencellid"]

Antenna sources eligible for automatic routing, as a JSON list

OWRT_OPENCELLID_TOKEN

unset

OpenCelliD API token for the export download; never recorded

OWRT_LOCAL_ANTENNAS

unset

GeoJSON or CSV file of the local antenna source

OWRT_SOURCE_CACHE_ROOT

.cache/sources

Snapshots of antenna sources, relative to the checkout

OWRT_MAX_SURFACE_FEATURES_PER_THEME

20000

Overture surface features per theme

OWRT_HTTP_REQUEST_TIMEOUT_SECONDS

60

Provider HTTP timeout

OWRT_OVERTURE_CONNECT_TIMEOUT_SECONDS

15

Overture connect timeout

OWRT_OVERTURE_REQUEST_TIMEOUT_SECONDS

60

Overture request timeout

OWRT_USER_AGENT

project string

Sent to Nominatim and Overpass

OWRT_OVERPASS_URL

public Overpass

Overpass endpoint; deploy a private instance for sustained use

OWRT_NOMINATIM_URL

public Nominatim

Search endpoint

OWRT_DATASET_ROOT

data/generated

Output root for datasets

OWRT_SCENE_CACHE_ROOT

.cache/scenes

Cache root of compiled scenes, shared by the loader and the service, relative to the checkout

OWRT_OVERTURE_INDEX_ROOT

.cache/overture-index

Cached Overture STAC index per release

OWRT_ENGINE_SPEC_DIRECTORY

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.