Docker

Betrieb als Docker-Container

Der LxLogger steht als Multi-Arch-Image (amd64 + arm64) zur Verfügung:

ghcr.io/6fdigital/lxlogger:latest

Docker installieren

Eine Anleitung zur Installation von Docker auf deinem System findest du unter Installation von Docker.

Vorbereitung

Du benötigst:

• einen Lizenzschlüssel aus deinem Konto auf lxlogger.de (siehe Lizenzierung),
• eine Konfigurationsdatei (lxlogger.toml) – siehe Konfigurationsdatei,
• ein erreichbares InfluxDB-Ziel (v2 empfohlen).

Lege dazu auf dem Host ein Verzeichnis an, das Konfiguration, Lizenz und das persistente Datenverzeichnis aufnimmt:

mkdir -p ~/lxlogger/data
# lxlogger.toml und license in ~/lxlogger ablegen

Daten persistent halten

Binde /var/lib/lxlogger als dauerhaftes Volume ein. Dort liegt der lokale Datenpuffer – nur so bleiben zwischengespeicherte Daten über einen Neustart oder ein Update des Containers hinweg erhalten.

Container starten

docker run -d \
  --name lxlogger \
  -v ~/lxlogger/lxlogger.toml:/etc/lxlogger/lxlogger.toml:ro \
  -v ~/lxlogger/license:/etc/lxlogger/license:ro \
  -v ~/lxlogger/data:/var/lib/lxlogger \
  ghcr.io/6fdigital/lxlogger:latest up

Geheimnisse sicher übergeben

Übergib Passwörter und Tokens nicht als -e VAR=wert, sondern als gemountete Dateien über die _FILE-Konvention:

docker run -d \
  --name lxlogger \
  -v ~/lxlogger/lxlogger.toml:/etc/lxlogger/lxlogger.toml:ro \
  -v ~/lxlogger/license:/etc/lxlogger/license:ro \
  -v ~/lxlogger/data:/var/lib/lxlogger \
  -v ~/lxlogger/secrets/influx_token:/run/secrets/influx_token:ro \
  -e LXL_SINK_INFLUXDB_V2_TOKEN_FILE=/run/secrets/influx_token \
  ghcr.io/6fdigital/lxlogger:latest up

Die entsprechenden Werte (token, password) in der lxlogger.toml können dann entfallen.

Beispiel mit Docker Compose

Das folgende Beispiel startet den LxLogger zusammen mit InfluxDB v2 und Grafana:

services:
  influxdb:
    image: influxdb:2
    volumes:
      - influxdb-data:/var/lib/influxdb2
    ports:
      - "8086:8086"

  grafana:
    image: grafana/grafana:latest
    volumes:
      - grafana-data:/var/lib/grafana
    ports:
      - "3000:3000"

  lxlogger:
    image: ghcr.io/6fdigital/lxlogger:latest
    command: up
    depends_on:
      - influxdb
    volumes:
      - ./lxlogger.toml:/etc/lxlogger/lxlogger.toml:ro
      - ./license:/etc/lxlogger/license:ro
      - lxlogger-data:/var/lib/lxlogger

volumes:
  influxdb-data:
  grafana-data:
  lxlogger-data:

Grafana ist anschließend unter http://localhost:3000 erreichbar (Standard-Login admin/admin). Die Einrichtung der Datenquelle beschreibt die Seite Konfiguration Grafana.