# Konfiguration von Watchtower

> Die Umgebungsvariablen von Watchtower für das Prüfintervall, das Scope-Label, das Aufräumen alter Images und die Zeitzone im Protokoll.

Watchtower wird über Umgebungsvariablen konfiguriert.

## Umgebungsvariablen

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

Abstand zwischen zwei Prüfungen auf neue Images, in Sekunden. Standardwert ist `86400`, also einmal am Tag. Der Abstand zählt ab dem Start des Containers.

Zwischen zwei Prüfungen bleibt ein Container auf seiner Version, auch wenn im Registry längst eine neuere liegt.

```properties title="Beispiel"
WATCHTOWER_POLL_INTERVAL=28800
```

> **HELIOS**
>
>
> HELIOS setzt den Wert immer, standardmäßig `86400`. Zur Wahl stellt es ihn erst, wenn mindestens ein Dienst auf _Entwicklung_ steht, unter _Konfiguration → Grundeinstellungen → Software-Stand_. Dort stehen täglich (`86400`), alle 8 Stunden (`28800`) und stündlich (`3600`).
>

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

Beschränkt Watchtower auf die Container, die das Label `com.centurylinklabs.watchtower.scope` mit genau diesem Wert tragen. Welche Dienste von SOLECTRUS das Label bekommen, steht in der [Übersicht](/docs/referenz/watchtower/). Der Sonderwert `none` kehrt die Auswahl um: Watchtower übergeht dann alle Container, die ein Scope-Label tragen.

Ohne die Variable nimmt sich Watchtower **jeden** Container auf dem Host vor, auch die, die nichts mit SOLECTRUS zu tun haben.

```properties title="Beispiel"
WATCHTOWER_SCOPE=solectrus
```

> **HELIOS**
>
>
> HELIOS gibt `solectrus` vor, einzustellen gibt es nichts.
>

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

Entfernt das alte Image, sobald der Container auf die neue Version umgestellt ist. Erlaubt sind `true` und `false`. Standardwert ist `false`.

Ohne die Einstellung bleiben die abgelösten Images liegen und belegen weiter Platz auf der Platte.

```properties title="Beispiel"
WATCHTOWER_CLEANUP=true
```

> **HELIOS**
>
>
> HELIOS setzt `true`, einzustellen gibt es nichts.
>

### `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 die Zeitstempel im Protokoll von Watchtower. Auf den Abstand zwischen zwei Prüfungen wirkt sie sich nicht aus, den bestimmt allein `WATCHTOWER_POLL_INTERVAL`.

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

> **HELIOS**
>
>
> HELIOS fragt die Zeitzone unter _Konfiguration → Grundeinstellungen → PV-Anlage_ ab, vorbelegt mit `Europe/Berlin`.
>

## Weitere Variablen

Watchtower kennt noch etliche Variablen mehr, etwa für Benachrichtigungen bei Updates, private Registries oder eine HTTP-API. HELIOS setzt keine davon, und für den Betrieb von SOLECTRUS braucht es sie nicht.

Wer sie trotzdem nutzen will, findet sie in der Dokumentation des Watchtower-Projekts unter [Configuration → Arguments](https://watchtower.nickfedor.com/latest/configuration/arguments/). Zu beachten ist dabei: HELIOS erzeugt die `compose.yaml` bei jeder Änderung neu und verwirft dabei alles, was es nicht selbst geschrieben hat.