Linux

Installation unter Linux

Der empfohlene Weg unter Linux ist unser signiertes Paket-Repository auf downloads.lxlogger.de. Das Paket legt einen Systembenutzer lxlogger, das Datenverzeichnis /var/lib/lxlogger und eine systemd-Unit an und startet den Dienst automatisch. Spätere Updates erfolgen einfach per apt upgrade bzw. dnf upgrade (siehe Updates).

Datenbank & Visualisierung

Diese Anleitung installiert den LxLogger. Eine erreichbare InfluxDB (v2 empfohlen, v1.8 unterstützt) und – für die Visualisierung – Grafana richtest du separat ein; sie können auf demselben oder einem anderen Gerät laufen. Die Anbindung von Grafana beschreibt die Seite Konfiguration Grafana.

1. Repository einrichten und installieren

Debian / Ubuntu / Raspberry Pi OS

# Repo-Schlüssel hinterlegen
curl -fsSL https://downloads.lxlogger.de/apt/lxlogger-archive-keyring.gpg \
  | sudo tee /usr/share/keyrings/lxlogger.gpg > /dev/null

# Repo eintragen (Suite `stable`)
echo "deb [signed-by=/usr/share/keyrings/lxlogger.gpg] https://downloads.lxlogger.de/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/lxlogger.list

# Installieren
sudo apt update
sudo apt install lxlogger

apt wählt automatisch das passende Paket für deine Architektur aus.

Fedora / RHEL / Rocky / AlmaLinux

# Repo-Definition ablegen
curl -fsSL https://downloads.lxlogger.de/rpm/lxlogger.repo \
  | sudo tee /etc/yum.repos.d/lxlogger.repo > /dev/null

# Installieren
sudo dnf install lxlogger

Funktioniert mit dnf4, dnf5, yum und microdnf gleichermaßen.

Dienst läuft zunächst auf Fehler

Direkt nach der Installation läuft der Dienst in einer Fehlerschleife, bis Lizenz und Konfiguration vorhanden sind – das ist erwartet. Weiter mit den folgenden Schritten.

2. Lizenzschlüssel ablegen

Hole deinen Lizenzschlüssel aus deinem Konto auf lxlogger.de (eine Zeile, beginnt mit LXL1-) und lege ihn systemweit ab:

sudo install -d -m 0755 /etc/lxlogger
printf '%s\n' 'LXL1-DEIN-TOKEN' | sudo tee /etc/lxlogger/license >/dev/null
sudo chown root:lxlogger /etc/lxlogger/license
sudo chmod 0640 /etc/lxlogger/license

Mehr dazu unter Lizenzierung.

3. Konfiguration anlegen

Kopiere die mitgelieferte Vorlage und passe sie an – der Dienst liest /etc/lxlogger/lxlogger.toml:

sudo cp /etc/lxlogger/lxlogger.toml.example /etc/lxlogger/lxlogger.toml
sudo chown root:lxlogger /etc/lxlogger/lxlogger.toml
sudo chmod 0640 /etc/lxlogger/lxlogger.toml
sudo nano /etc/lxlogger/lxlogger.toml

Minimal nötig sind [miniserver] und genau ein [[sinks]]-Eintrag. Alle Details findest du unter Konfigurationsdatei.

4. Prüfen und starten

lxlogger check --config /etc/lxlogger/lxlogger.toml   # Konfiguration & Miniserver prüfen
sudo systemctl restart lxlogger                       # Dienst (neu) starten
systemctl status lxlogger                             # Status ansehen
journalctl -u lxlogger -f                             # Logs live verfolgen

Der Dienst ist bereits für den Autostart beim Booten aktiviert. Fahre nun wie unter Konfiguration Grafana beschrieben mit der Einrichtung der Visualisierung fort.

Vervollständigung mit der Tab-Taste

Das Paket bringt die Shell-Vervollständigung für bash, zsh und fish mit. Öffne eine neue Shell, dann ergänzt Tab die Befehle und Optionen des LxLogger. Mehr dazu unter Shell-Vervollständigung einrichten.

Befehle als eigener Benutzer ausführen

Konfiguration (/etc/lxlogger) und Datenverzeichnis (/var/lib/lxlogger) gehören dem Systembenutzer lxlogger. Manuelle Aufrufe wie lxlogger check oder lxlogger secret … als normaler Benutzer können daher mit Rechtefehlern fehlschlagen. Zwei Lösungen:

• Eigenen Benutzer der Gruppe lxlogger hinzufügen (danach neu anmelden):

  sudo usermod -aG lxlogger $USER

• Oder den Befehl direkt als Dienstbenutzer ausführen:

  sudo -u lxlogger lxlogger check --config /etc/lxlogger/lxlogger.toml

Zeitzone prüfen

Der Miniserver speichert seine Statistiken in Ortszeit, ohne Angabe der Zeitzone. lxlogger import liest sie in der Zeitzone aus [miniserver] timezone. Ohne Angabe gilt die Zeitzone des Servers. Das laufende Logging ist davon nicht betroffen, nur der Datenimport.

Prüfe die Zeitzone deines Servers:

timedatectl

Weicht sie von der Zeitzone deines Miniservers ab, z. B. Time zone: Etc/UTC, trage die Zeitzone des Miniservers in /etc/lxlogger/lxlogger.toml ein:

[miniserver]
timezone = "Europe/Berlin"

Am besten setzt du timezone immer. Dann hängt der Import nicht von der Zeitzone des Servers ab. Passt die Zeitzone nicht zum Miniserver, bricht der Import ab, bevor er etwas schreibt.

Werte um 1–2 Stunden verschoben?

Hast du bereits auf einem UTC-Server importiert, sind die Werte im Winter um eine und im Sommer um zwei Stunden verschoben. Wie du sie korrigierst, steht unter Bereits importierte Werte korrigieren.

Raspberry Pi

Auf dem Raspberry Pi (Raspberry Pi OS) gilt dieselbe apt-Installation wie oben – folge einfach dem Tab „Debian / Ubuntu / Raspberry Pi OS”. Beachte nur die folgenden Besonderheiten:

• Unterstützte Modelle: Pi 2, 3, 4, 5 sowie Pi Zero 2 W. Der Pi 1 und Pi Zero / Zero W (ARMv6) werden nicht unterstützt.
• Architektur: apt wählt automatisch das passende Paket – arm64 auf Pi 4/5 mit 64-bit OS, armhf auf Pi 2/3 und Zero 2 W mit 32-bit OS. Deine Variante zeigt dpkg --print-architecture.

Hinweis zu Geheimnissen auf dem Pi

Da der LxLogger auf dem Pi als Hintergrunddienst (ohne angemeldete Sitzung) läuft, steht der OS-Schlüsselbund dort nicht zur Verfügung. Hinterlege Passwort und Token deshalb als gemountete Dateien über die _FILE-Variante – siehe den Abschnitt „Geheimnisse” unter Konfigurationsdatei.

Variante: manuelles .deb/.rpm (ohne Repository)

Für Setups ohne Internetzugang stehen die einzelnen Pakete pro Version weiterhin zum direkten Download bereit. Bestimme zunächst deine Architektur und installiere das passende Paket:

# Architektur ermitteln
dpkg --print-architecture    # Debian/Ubuntu: amd64 | arm64 | armhf
uname -m                     # x86_64 | aarch64 | armv7l

# Beispiel Debian/Ubuntu
sudo apt install ./lxlogger_<version>_<arch>.deb

# Beispiel Fedora/RHEL
sudo dnf install ./lxlogger-<version>.<arch>.rpm

Lizenz, Konfiguration und Dienststart anschließend wie in den Schritten 2–4.