Skip to main content

Environment Variables

TeslaMate accepts the following environment variables for runtime configuration:

Variable NameDescriptionDefault Value
DATABASE_USERUsername (required)
DATABASE_PASSUser password (required)
DATABASE_NAMEThe database to connect to (required)
DATABASE_HOSTHostname of the database server (required)
DATABASE_PORTPort of the database server5432
DATABASE_POOL_SIZESize of the database connection pool10
DATABASE_TIMEOUTThe time in milliseconds to wait for database query calls to finish60000
DATABASE_SSLSet to true if SSL should be usedfalse
DATABASE_IPV6Set to true if IPv6 should be usedfalse
VIRTUAL_HOSTHost part used for generating URLs throughout the applocalhost
CHECK_ORIGINConfigures whether to check the origin header or not. May be true (recommended), false (default) or a comma-separated list of hosts that are allowed (e.g. https://example.com,//another.com:8080). Hosts also support wildcards. If true, it will check against the host value in VIRTUAL_HOST.false
PORTPort where the web interface is exposed4000
HTTP_BINDING_ADDRESSIP address where the web interface is exposed, or blank (default) meaning all addresses.
DISABLE_MQTTDisables the MQTT feature if truefalse
MQTT_HOSTHostname of the broker (required unless DISABLE_MQTT is true)
MQTT_PORTPort of the broker1883 (8883 for MQTT over TLS)
MQTT_USERNAMEUsername
MQTT_PASSWORDPassword
MQTT_TLSEnables TLS if truefalse
MQTT_TLS_ACCEPT_INVALID_CERTSAccepts invalid certificates if truefalse
MQTT_IPV6Set to true if IPv6 should be usedfalse
MQTT_NAMESPACEInserts a custom namespace into the MQTT topic . For example, with MQTT_NAMESPACE=account_0: teslamate/account_0/cars/$car_id/state.
IMPORT_DIRThe path of the directory for the import of data (e.g. TeslaFi)./import
TZUsed to establish the local time zone, e.g. to use the local time in logs. See List of tz database time zones.