Server Configuration
Configure environment variables, ports, TLS, and performance tuning.
Last updated March 15, 2026
Open VTS is configured through an XML properties file and optional environment variable overrides. This reference covers every key setting.
Configuration File Location
The primary configuration file is located at conf/openvts.xml (relative to the installation directory). In Docker, mount your custom file to /opt/openvts/conf/openvts.xml.
Core Settings
| Key | Description | Default |
|---|---|---|
| web.port | HTTP port for the web interface | 8082 |
| web.address | Bind address (0.0.0.0 for all interfaces) | 0.0.0.0 |
| web.url | Public URL (for link generation) | http://localhost:8082 |
| geocoder.enable | Enable reverse geocoding | true |
| geocoder.type | Geocoder provider (nominatim, google, mapbox) | nominatim |
| logger.level | Application log level | INFO |
| filter.enable | Enable position filtering | true |
| filter.distance | Minimum distance between positions (meters) | 0 |
TLS / HTTPS Configuration
conf/openvts.xml
<entry key="web.port">8443</entry>
<entry key="web.ssl.enable">true</entry>
<entry key="web.ssl.key">/etc/ssl/private/openvts.key</entry>
<entry key="web.ssl.cert">/etc/ssl/certs/openvts.crt</entry>Warning
For production, we recommend using a reverse proxy (Nginx, Caddy) for TLS termination instead of configuring TLS directly in Open VTS.
Performance Tuning
| Key | Description | Default |
|---|---|---|
| web.maxThreads | Maximum HTTP handler threads | 32 |
| database.maximumPoolSize | Database connection pool size | 10 |
| processing.threads | Device message processing threads | 4 |
| event.enable | Enable event processing engine | true |
Tip
For fleets over 1,000 vehicles, increase
database.maximumPoolSize to 25–50 and processing.threads to match your CPU core count.