komoot2mqtt
Inhalt der Doku

komoot2mqtt · Doku

Konfiguration

Alle Umgebungsvariablen von komoot2mqtt für komoot, MQTT, Ablauf, Home Assistant und den Datenbank-Import.

Auf dieser Seite

Jede Einstellung geht als Umgebungsvariable, in einer .env-Datei oder als Option auf der Kommandozeile (gleicher Name wie in der Spalte „Option“, z. B. --mqttHost). Die Kommandozeile gewinnt.

Schalter (Ja/Nein) verstehen true und 1 als ja, alles andere als nein.

komoot

Variable Option Standard Beschreibung
K2M_KOMOOT_EMAIL komootEmail Pflicht E-Mail-Adresse des komoot-Kontos
K2M_KOMOOT_PASSWORD komootPassword Pflicht Passwort des komoot-Kontos
K2M_FILTER_SPORT filterSport alle Nur Touren dieser Sportart, z. B. touringbicycle
K2M_FILTER_AFTER_DATE filterAfterDate alle Nur Touren ab diesem Zeitpunkt, z. B. 2026-01-01T00:00:00.000Z

MQTT

Variable Option Standard Beschreibung
K2M_MQTT_HOST mqttHost Pflicht Adresse des Brokers, z. B. mqtt://192.168.1.10:1883
K2M_MQTT_USER mqttUser Pflicht Benutzer am Broker
K2M_MQTT_PASSWORD mqttPassword Pflicht Passwort am Broker
K2M_MQTT_KEEPALIVE mqttKeepAlive 60 Keep-Alive in Sekunden
K2M_MQTT_VERSION mqttVersion 4 MQTT-Protokollversion (4 = 3.1.1, 5 = 5.0)
K2M_MQTT_BASE_TOPIC mqttBaseTopic komoot2mqtt Basis aller Topics, siehe MQTT
K2M_MQTT_RETAIN mqttRetain true Nachrichten als „retained“ senden

Ablauf

Variable Option Standard Beschreibung
K2M_INTERVAL interval 600000 Abstand zwischen zwei Abfragen in Millisekunden (10 Minuten)
K2M_INTERVAL_DISABLED intervalDisabled false Nach dem ersten Durchlauf beenden statt weiterzulaufen
K2M_PUBLISH_DISABLED publishDisabled false Beim ersten Durchlauf nichts per MQTT senden

Hinweis

K2M_PUBLISH_DISABLED wirkt nur auf den ersten Durchlauf. Läuft der Dienst danach im Intervall weiter, sendet er trotzdem. Zusammen mit K2M_INTERVAL_DISABLED=true sendet er gar nichts – das ist die Einstellung für einen reinen Import.

Home Assistant

Variable Option Standard Beschreibung
K2M_HOMEASSISTANT_DISCOVERY homeAssistantDiscovery true Sensoren per MQTT Discovery anlegen
K2M_HOMEASSISTANT_BASE_TOPIC homeAssistantBaseTopic homeassistant Discovery-Präfix von Home Assistant
K2M_HOMEASSISTANT_STATISTIC_ID homeAssistantStatisticId komoot-statistic ID des Geräts für die Statistiken
K2M_HOMEASSISTANT_LAST_TOUR_ID homeAssistantLastTourId komoot-last-tour ID des Geräts für die letzte Tour

In beiden IDs ersetzt der Dienst {sport} durch den Wert von K2M_FILTER_SPORT. So kannst du mehrere Container für verschiedene Sportarten laufen lassen, ohne dass sich die Geräte in die Quere kommen, siehe Home Assistant.

Datenbank-Import

Nur nötig, wenn du den Verlauf in Home Assistant importieren willst, siehe Home Assistant.

Variable Option Standard Beschreibung
K2M_HOMEASSISTANT_DATABASE_IMPORT_HISTORICAL_DATA homeAssistantDatabaseImportHistoricalData false Verlauf beim Start importieren
K2M_HOMEASSISTANT_DATABASE_HOST homeAssistantDatabaseHost localhost Host der Datenbank
K2M_HOMEASSISTANT_DATABASE_PORT homeAssistantDatabasePort 3306 Port der Datenbank
K2M_HOMEASSISTANT_DATABASE_USER homeAssistantDatabaseUser leer Benutzer
K2M_HOMEASSISTANT_DATABASE_PASSWORD homeAssistantDatabasePassword leer Passwort
K2M_HOMEASSISTANT_DATABASE_NAME homeAssistantDatabaseName homeassistant Name der Datenbank
K2M_HOMEASSISTANT_DATABASE_CHARSET homeAssistantDatabaseCharset utf8mb4 Zeichensatz der Verbindung
K2M_HOMEASSISTANT_ENTITY_TEMPLATE homeAssistantEntityTemplate sensor.komoot2mqtt_{device}_{type}_{key} Muster, nach dem die Entitäten gesucht werden

Beispiel .env

K2M_KOMOOT_EMAIL=du@example.com
K2M_KOMOOT_PASSWORD=geheim

K2M_MQTT_HOST=mqtt://192.168.1.10:1883
K2M_MQTT_USER=komoot
K2M_MQTT_PASSWORD=geheim

K2M_FILTER_SPORT=touringbicycle
K2M_INTERVAL=900000

Achtung

Die .env enthält deine Zugangsdaten zu komoot und zum Broker. Sie steht in .gitignore, gib sie trotzdem nicht weiter.