obhutDoku

Linux-Agent installieren

Den obhut-Agent per Einmalbefehl auf einem systemd-Linux-Host starten.

Der Linux-Agent baut eine ausgehende Verbindung zu obhut auf und leitet eine interne Anwendung an den Edge weiter. Der Installer ist für die gehostete obhut-SaaS gedacht und unterstützt Linux amd64 und arm64 mit systemd.

Geltungsbereich

Diese Anleitung beschreibt den Tunnel-Agent für gehostete obhut-SaaS. Sie ist kein Self-Host-, Air-Gap-, Kubernetes- oder Windows-Installationspfad.

Voraussetzungen

  • Ein Linux-Host mit systemd.
  • Root-Rechte auf diesem Host.
  • Ausgehender HTTPS-Zugriff auf https://obhut.io für Installer und Binary.
  • Eine interne Anwendung, die vom Host aus erreichbar ist, zum Beispiel http://127.0.0.1:8080.
  • Ein frisch erzeugter Agent im Dashboard. Der Enrollment-Token wird nur einmal angezeigt.

Installation

Agent im Dashboard erzeugen

Öffne die Agenten-Seite, lege einen neuen Agent an und kopiere den Installationsbefehl direkt aus dem Dialog.

Upstream setzen

Passe --upstream an die interne Anwendung an. Die Control-Plane- und Edge-Adressen sind im veröffentlichten Agent bereits enthalten und müssen nicht in den Befehl geschrieben werden.

Befehl als root ausführen

Führe den Befehl auf dem Linux-Host aus:

curl -fsSL https://obhut.io/install.sh | OBHUT_TOKEN=<enrollment-token> sh -s -- --upstream=http://127.0.0.1:8080

Der Installer erkennt die Architektur, lädt obhut-agent-linux-amd64 oder obhut-agent-linux-arm64, prüft SHA256SUMS, schreibt /etc/obhut/agent.json mit Dateirechten 0600 und startet obhut-agent als systemd-Dienst.

Token nicht als Argument übergeben

Der Enrollment-Token gehört in OBHUT_TOKEN oder in die interaktive Eingabeaufforderung des Installers. Nicht als Kommandozeilenargument anhängen.

Verifizieren

Prüfe auf dem Host:

systemctl status obhut-agent
journalctl -u obhut-agent -f

Im Dashboard sollte der Agent innerhalb kurzer Zeit als online erscheinen. Wenn im Journal invalid_enrollment auftaucht, wurde ein falscher, gelöschter oder bereits ersetzter Token verwendet. Erzeuge dann einen neuen Agent oder Token und installiere erneut.

Deinstallation

curl -fsSL https://obhut.io/install.sh | sh -s -- --uninstall

Die Deinstallation stoppt und entfernt Dienst, Binary und lokale Konfiguration. Sie entfernt keine manuell angelegten Firewall-Regeln. Segmentierungs- Enforcement ist in diesem Installationspfad nicht aktiv.