💾 Agent auf TrueNAS

Wenn du ein TrueNAS in der Werkstatt hast, hast du schon einen Platz für den lokalen Agenten: Es läuft den ganzen Tag und steht im selben Netzwerk wie deine Drucker. Der Agent läuft als ganz normale TrueNAS-App, neben denen, die du schon hast.

Diese Seite erklärt, wie du ihn installierst, mit deiner Werkstatt verknüpfst, aktualisierst, umziehst und entfernst. Was der Agent ist und welche Drucker er anbindet, steht unter Der lokale Agent.

---

Bevor du anfängst

Was du brauchst	Wie du es prüfst
TrueNAS 24.10 oder neuer (Community Edition)	In TrueNAS unter Dashboard → System Information → Version. Ältere Versionen haben kein Install via YAML.
Die Apps von TrueNAS sind aktiviert	Unter Apps steht oben Apps Service Running. Beim ersten Mal fragt TrueNAS dich, auf welchem Pool sie gespeichert werden sollen.
Du meldest dich bei TrueNAS mit einem Administrator-Benutzer an	Nur ein Administrator kann Apps installieren.
Du bist Inhaber der Werkstatt in BolloPrint	Beim Verknüpfen erscheinen nur die Werkstätten, deren Inhaber du bist.
Das TrueNAS und die Drucker sind im selben Netzwerk	Wenn sie in getrennten Netzwerken sind, funktioniert der Agent genauso, aber du musst die Drucker über ihre IP hinzufügen.
Das TrueNAS kommt ins Internet	Mehr nicht: Keine Ports öffnen, keine feste IP nötig.

---

1. Kopier das YAML aus BolloPrint

Geh in BolloPrint zu Einstellungen → Drucker → Lokaler Agent → Neuer Agent und wähl TrueNAS.

Du siehst die Schritte und darunter einen Kasten mit dem YAML: dem Text, der TrueNAS sagt, was installiert werden soll. Drück auf Kopieren.

Auf diesem Bildschirm musst du nichts anlegen: Das YAML ist für alle Werkstätten gleich und enthält keine Schlüssel. Der Agent entsteht erst, wenn du ihn verknüpfst, in Schritt 3.

Falls es dich interessiert, was es macht: Das YAML sieht so aus (kopier immer das aus BolloPrint, da steht in der Zeile image: die passende Version):

services:
  bolloprint-agent:
    image: ghcr.io/bolloprint/bolloprint-agent:XXXX
    restart: unless-stopped
    network_mode: host
    mem_limit: 512m
    pids_limit: 512
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    environment:
      BP_PLATFORM: truenas
      BP_LINK_LISTEN: ":8257"
    volumes:
      - data:/var/lib/bolloprint

volumes:
  data:

x-portals:
  - name: Web UI
    scheme: http
    host: 0.0.0.0
    port: 8257
    path: /

• network_mode: host setzt den Agenten ins Netzwerk deines TrueNAS: So findet er die Drucker.
• BP_LINK_LISTEN öffnet seine Seite auf Port 8257, und x-portals sorgt für den Button Web UI in TrueNAS.
• data ist der Ordner, in dem der Agent seine Identität und seine Verknüpfung speichert. Er übersteht Neustarts und Updates.

---

2. Installier ihn auf TrueNAS

1. Melde dich bei TrueNAS an und öffne Apps.
2. Drück auf Discover Apps.
3. Oben rechts, neben Custom App, öffnest du das Menü ⋮ und wählst Install via YAML.
4. Gib bei Name bolloprint-agent ein.
5. Füg bei Custom Config das kopierte YAML ein.
6. Drück auf Save.

TrueNAS lädt den Agenten herunter und startet ihn. Nach etwa einer Minute erscheint er unter Apps → Installed als Running.

---

3. Verknüpf ihn mit deiner Werkstatt

1. Drück unter Apps → Installed auf bolloprint-agent. Rechts, unter Application Info, drückst du auf Web UI. Die Seite des Agenten öffnet sich in einem neuen Tab.
2. Auf der Seite steht „Dieser Agent gehört noch zu keiner Werkstatt“, und sie zeigt einen Code aus acht Zeichen, etwa 6E7B-9DEF. Drück auf Mit BolloPrint verknüpfen.
3. BolloPrint öffnet sich. Wenn du nicht angemeldet bist, meld dich an. Wähl die Werkstatt, zu der du ihn hinzufügst.
4. BolloPrint zeigt dir das Gerät (den Namen deines TrueNAS und „TrueNAS“) und den Code. Prüf, ob es derselbe ist wie auf der Seite des Agenten, gib dem Agenten einen Namen und drück auf Zur Werkstatt hinzufügen.
5. Du landest wieder in BolloPrint, in der Liste der Agenten. Auf der Seite des Agenten steht jetzt Verknüpft mit deiner Werkstatt.

Fertig. Unter Einstellungen → Drucker → Lokaler Agent siehst du den Agenten mit dem TrueNAS-Logo, Online.

---

4. Gib ihm die Drucker

Der Agent sucht in deinem Netzwerk nach Druckern, sobald er verknüpft ist. Was er findet, erscheint unter Drucker im lokalen Netzwerk, unter der Liste der Agenten, und dort legst du sie an. Die, die nicht von selbst erscheinen, fügst du mit Per IP hinzufügen hinzu.

Wie das bei jeder Marke geht, steht unter Drucker über das lokale Netzwerk.

---

Aktualisieren

Du musst nichts tun. Der Agent aktualisiert sich von allein: Wenn eine neue Version erscheint, lädt er sie herunter, prüft, dass sie von uns ist, und startet mit ihr neu. Er speichert sie in seinem Datenordner, daher bleibt er bei dieser Version, auch wenn du die App oder das TrueNAS neu startest.

Deshalb zeigt die App in TrueNAS weiterhin Up to date, und die Zeile image: in ihrem YAML ändert sich nicht: Das ist die Version, mit der er installiert wurde, nicht die, die gerade läuft. Die laufende Version siehst du in BolloPrint, neben dem Agenten.

Nur wenn BolloPrint dich darauf hinweist, dass dieser Agent eine manuelle Aktualisierung braucht:

1. Drück unter Apps → Installed auf bolloprint-agent und dann auf Edit.
2. Ändere bei Custom Config nur die Version am Ende der Zeile image: in die, die BolloPrint unter Neuer Agent → TrueNAS anzeigt. Fass sonst nichts an.
3. Drück auf Save.

Der Agent bleibt mit derselben Werkstatt verknüpft, mit denselben Druckern und ihrem Verlauf. Du musst nichts neu verknüpfen.

---

Auf einen anderen Rechner umziehen oder neu installieren

Ein Agent, der von Grund auf installiert wird, auf einem anderen Rechner oder auf demselben nach dem Löschen, ist ein neuer Agent:

1. Installier und verknüpf ihn wie in den Schritten 1 bis 3.
2. Füg deine Drucker zum neuen Agenten hinzu: Sie wechseln mit ihrem Verlauf zu ihm.
3. Lösch den alten Agenten in BolloPrint (Einstellungen → Drucker → Lokaler Agent, Menü ⋮ des Agenten → Löschen).

---

Entfernen

1. Lösch den Agenten in BolloPrint: Einstellungen → Drucker → Lokaler Agent, Menü ⋮ des Agenten → Löschen. Nach ein paar Sekunden merkt der Agent das, und seine Seite bietet wieder Mit BolloPrint verknüpfen an.
2. In TrueNAS: Apps → Installed → bolloprint-agent → Delete.

Wenn du ihn nur in TrueNAS löschst, erscheint er in BolloPrint weiter als Offline, bis du ihn auch dort löschst.

---

Wenn etwas nicht klappt

Was du siehst	Was du tun kannst
Du findest Install via YAML nicht	Dein TrueNAS ist älter als 24.10, oder die Apps sind nicht aktiviert (wähl unter Apps den Pool, nach dem gefragt wird).
Die App kommt nicht über Deploying hinaus oder bleibt bei Stopped	Das TrueNAS kommt nicht ins Internet, um den Agenten herunterzuladen. Prüf das Netzwerk des TrueNAS und starte die App unter Apps → Installed neu.
Web UI öffnet eine Seite, die nicht lädt	Eine andere App nutzt schon Port 8257. Ändere unter Edit ":8257" in ":8364" und das port: 8257 weiter unten in port: 8364, beide, und drück auf Save.
Der Code in BolloPrint stimmt nicht mit dem auf der Seite überein	Nicht bestätigen. Geh zurück zur Seite des Agenten und drück noch einmal auf Mit BolloPrint verknüpfen.
Der Agent erscheint in BolloPrint als Offline	Prüf in TrueNAS, ob die App Running ist und ob das TrueNAS ins Internet kommt. Sein Log findest du unter Apps → Installed → bolloprint-agent → Workloads, beim Log-Symbol.
Er ist verknüpft, findet aber keine Drucker	Das TrueNAS und die Drucker müssen im selben Netzwerk sein. Wenn nicht, füg sie mit Per IP hinzufügen hinzu.