# Konfiguration von Mosquitto

> Die Umgebungsvariablen des MQTT-Brokers, den HELIOS betreibt, für die Anmeldung, den Speicherort und die Zeitzone im Protokoll.

Mosquitto läuft im offiziellen Docker-Image. Eine Konfigurationsdatei gibt es nicht: Beim Start schreibt der Container sie aus den folgenden Variablen selbst.

## Umgebungsvariablen

### `MQTT_USERNAME`<span class="badge required"></span>

Benutzername für die Anmeldung am Broker. Jedes Gerät meldet sich damit an, der [MQTT-Collector](/docs/referenz/mqtt-collector/konfiguration/#mqtt_username) ebenso.

```properties title="Beispiel"
MQTT_USERNAME=solectrus
```

> **HELIOS**
>
>
> HELIOS fragt den Benutzernamen unter _Konfiguration → Datenquellen → MQTT_ ab, vorbelegt mit `solectrus`.
>

### `MQTT_PASSWORD`<span class="badge required"></span>

Passwort für die Anmeldung am Broker. Fehlt es, startet der Broker nicht, und der MQTT-Collector wartet vergeblich auf ihn.

Manche Geräte erwarten das Passwort als Teil der Broker-Adresse und scheitern dort an Sonderzeichen. Buchstaben und Ziffern funktionieren überall.

```properties title="Beispiel"
MQTT_PASSWORD=my-secret-password
```

> **HELIOS**
>
>
> HELIOS fragt das Passwort unter _Konfiguration → Datenquellen → MQTT_ ab. Das Feld ist ein Pflichtfeld.
>

### `MOSQUITTO_VOLUME_PATH`<span class="badge required"></span>

Pfad, in dem Mosquitto seine Daten ablegt. Er geht nicht an Mosquitto selbst, sondern an Docker, das ihn als Volume in den Container mountet. Dort liegen die gespeicherten Nachrichten mit dem Flag _retain_.

```properties title="Beispiel"
MOSQUITTO_VOLUME_PATH=/somewhere/solectrus/mosquitto
```

> **HELIOS**
>
>
> HELIOS legt den Pfad fest, standardmäßig auf den Unterordner `mosquitto` im Installationsverzeichnis. Unter _Konfiguration → Einstellungen → Speicherorte_ zeigt HELIOS ihn an.
>

### `TZ`<span class="badge optional"></span>

Zeitzone gemäß [Liste](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Standardwert ist `UTC`.

Sie betrifft ausschließlich die Zeitstempel im Protokoll des Containers.

```properties title="Beispiel"
TZ=Europe/Berlin
```

> **HELIOS**
>
>
> HELIOS fragt die Zeitzone unter _Konfiguration → Einstellungen → Grundeinstellungen_ ab, vorbelegt mit `Europe/Berlin`.
>