NAS Guard Hilfe

Agent installieren (TrueNAS SCALE)
EN DE

Inhalt

Übersicht Erste Schritte Agent installieren (TrueNAS SCALE) Pairing TrueNAS TLS / Zertifikat-Pin Probleme lösen FAQ
TrueNAS SCALE
NAS Guard Agent installieren

Diese Anleitung nutzt genau die Installationsmethode aus TrueNAS SCALE: Apps → Installed → Edit → Edit App YAML. Du kopierst das YAML 1:1 hinein.

Was du brauchst

  • TrueNAS SCALE mit aktivierten Apps.
  • Einen Dataset-/Verzeichnis-Pfad für persistente Agent-Daten (Host Path).
  • Zugriff auf das Container-Image des NAS Guard Agents.
Wichtig: Der Agent braucht persistente Daten unter /data. Sonst gehen Pairing-Status und Zertifikat-Pin nach Updates/Neustarts verloren.

Schritt 1: Dataset/Verzeichnis für Agent-Daten anlegen

  1. In TrueNAS Datasets öffnen.
  2. Dataset oder Verzeichnis anlegen, das du in den Container mountest (Beispiel: /mnt/POOL/apps/nas-guard-agent).
Dieser Pfad ist Pflicht. Du trägst ihn gleich im YAML unter volumes: ein.

Schritt 2: Installation/Update über „Edit App YAML“

  1. Apps → Installed öffnen.
  2. Deine App auswählen (z.B. Name: agent).
  3. Edit → Edit App YAML klicken.
  4. Das YAML durch folgendes ersetzen (copy/paste):
services:
  nas-guard-agent:
    container_name: nas-guard-agent
    environment:
      - NASGUARD_PUSH_BASE_URL=https://apn.no-logs.de
      - NASGUARD_DATA_DIR=/data
    image: registry.git.hans-renz.de/hans/nas-guard-agent-images:latest
    ports:
      - '18080:8080'
    pull_policy: always
    restart: unless-stopped
    volumes:
      - /mnt/POOL/apps/nas-guard-agent:/data
Nur diese Zeilen bei Bedarf anpassen:
  • Datenpfad: /mnt/POOL/apps/nas-guard-agent:/data → /mnt/POOL/... durch deinen Dataset-Pfad ersetzen.
  • Web UI Port: '18080:8080' → 18080 ändern, falls der Port schon belegt ist.
Erwartetes Ergebnis: Nach dem Speichern wird der App-Status Running und in den Workloads/Ports siehst du 18080:8080.

Schritt 3: Agent Web UI öffnen

  1. Im Browser öffnen: http://<truenas-ip>:18080/ (Host-Port entsprechend anpassen, falls du ihn geändert hast).
  2. Du solltest die NAS Guard Agent Seite sehen.
Wenn es nicht aufgeht: Port-Mapping prüfen und ob die App läuft. Siehe Probleme lösen.
Weiter: Pairing
help.no-logs.de