Configuration#

Settings are read from environment variables with the OWRT_ prefix or from an ignored .env file in the working directory (.env.example lists them). 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

OWRT_CACHE_TTL_SECONDS

900

Lifetime of in-memory provider 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,boston

Sources eligible for automatic routing

OWRT_BOSTON_SOURCE_CATALOG

unset

Local Boston catalog for offline or historical releases

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 public providers

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 for loader scenes, relative to the checkout

OWRT_OVERTURE_INDEX_ROOT

.cache/overture-index

Cached Overture STAC index per release

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.

Public Overture and OSM access is remote and best effort. Nominatim allows one request per second and results must be cached; the OSM tile service is for interactive use only; Overpass is best effort. Production deployments should configure suitable provider capacity and keep attribution visible.