Inhalt des Handbuchs

🧩 Der lokale Agent

Der lokale Agent ist ein kleines Programm, das auf einem Rechner in deiner Werkstatt läuft. Er spricht über das Netzwerk vor Ort mit deinen Druckern und erzählt BolloPrint, was er sieht.

Er ist das Einzige, was installiert werden muss, um Drucker über das lokale Netzwerk zu verbinden, und einer reicht für die ganze Flotte.

Brauchst du ihn?

Deine Situation	Brauchst du den Agenten?
Du hast Bambu Lab und dir reicht es, sie über die Cloud zu sehen	Nein, aber mit dem Agenten bekommst du zusätzlich Kamera. Pausieren und abbrechen nicht: Bambu nimmt keine Befehle von fremden Programmen an, egal über welchen Weg
Du hast Prusa	Ja. Das ist der einzige Weg, sie zu verbinden
Du hast Elegoo-Harzdrucker oder eine Centauri	Ja. Es gibt keinen anderen Weg
Du hast QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, eine Creality K1 mit erreichbarem Moonraker oder irgendeine Maschine mit Klipper	Ja
Du hast FlashForge Adventurer 5M, AD5X oder Creator 5	Ja
Du willst nicht, dass deine Drucker ins Internet gehen	Ja. Der Agent spricht innerhalb deines Netzwerks mit ihnen

Installieren und aktuell halten

Zwei eigene Seiten, weil es zwei unterschiedliche Momente sind:

🚀 Den Agent ausrollen — wo er hingehört, wie du ihn in BolloPrint anlegst und wie du ihn auf deinem Rechner startest, mit Docker Compose, Portainer oder Kubernetes.
🔄 Den Agent aktualisieren — was zu tun ist, wenn BolloPrint dich auf eine neue Version hinweist. Es reicht, eine Zahl zu ändern und neu auszurollen.

Wie er sich verbindet

Der Agent ruft BolloPrint an, nicht umgekehrt. Genau deshalb funktioniert er, ohne dass du den Router anfassen musst: es müssen keine Ports geöffnet, keine feste IP beantragt und keine Firewall angepasst werden. Er funktioniert hinter einem ganz normalen Heimrouter, sogar bei Glasfaseranschlüssen ohne öffentliche IP.

Sobald er verbunden ist:

fragt er, um welche Drucker er sich kümmern soll,
verbindet sich mit jedem über dessen Protokoll,
und schickt laufend, was er sieht.

Wenn du in BolloPrint einen neuen Drucker anlegst, bekommt der Agent das von allein mit, in Sekunden. Er muss nicht neu gestartet werden.

Installationen freigeben

Die Installation aus dem Manifest, das du kopiert hast, kommt direkt herein. Jede andere Installation, die denselben Code verwendet, wartet auf dein Okay: Du siehst einen roten Hinweis über den Tabs und, im Agenten unter Status, die Installation unter Installationen warten auf Freigabe, mit dem Namen des Rechners, von dem aus sie sich verbindet.

Mit einem aktuellen Manifest passiert das kaum: Die Identität steht im Manifest selbst, du kannst den Agenten also auf eine andere Maschine umziehen oder neu installieren, und er bleibt derselbe. Normal ist es bei einem älteren Agenten, der mit einem Manifest ohne Identität ausgerollt wurde, wenn:

du ihn auf eine andere Maschine umziehst,
du sein Datenvolume löschst und neu anlegst,
du ihn von Grund auf neu installierst.

Drück auf Freigeben, wenn du den Rechner wiedererkennst. Sobald du einen freigibst, verliert der vorherige seinen Zugang.

Wenn eine wartende Installation auftaucht, die nicht von dir stammt, gib sie nicht frei: dann hat jemand anderes deinen Code. Öffne den Agenten, nutze Schlüssel neu erzeugen unter Bereitstellung und roll ihn mit dem neuen Manifest erneut aus.

Der Statusbildschirm

Im Tab Lokaler Agent gibt es zwei Bereiche:

Die Agenten, einer pro Zeile, mit Status und Version. Im Menü ⋮ jedes Agenten findest du Bearbeiten, das sein Fenster öffnet, und Löschen.
Drucker im lokalen Netzwerk, darunter: die aller deiner Agenten zusammen, jeder mit dem Agenten, der ihn steuert. Oben stehen Jetzt suchen und Per IP hinzufügen, und am Ende, was jeder Agent in deinem Netzwerk gefunden hat und welche Adressen er noch durchsucht.

Das Fenster eines Agenten hat zwei Tabs:

Status — was der Agent selbst meldet (die Tabelle unten), die wartenden Installationen und die Verbindung zu jedem Drucker. Hier änderst du auch seinen Namen.
Bereitstellung — das Manifest mit der aktuellen Version und Schlüssel neu erzeugen.

Was unter Status erscheinen kann:

Was du siehst	Was es bedeutet
Online	Er ist verbunden und arbeitet.
Kein aktuelles Signal	Er hat schon eine Weile kein Lebenszeichen gegeben. Meist ist der Rechner aus oder ohne Internet.
Offline	Er ist nicht da.
Sicherer Modus	Er ist gestartet und verbunden, verwaltet aber keine Drucker. Er nennt dir den Grund.
Puffer	Was er gespeichert hat, während er nichts senden konnte. Wenn „verworfene Nachrichten" erscheint, war der Ausfall so lang, dass nicht alles hineinpasste.
Aktualisiere deinen Agenten	Es gibt eine neuere Version. Das machst du auf deinem Rechner, nicht in BolloPrint: Ändere die Image-Version in deiner Datei und roll ihn neu aus. Schritt für Schritt in Den Agent aktualisieren.

Darunter Verbindung zu jedem Drucker: Maschine für Maschine, ob der Agent sie erreicht und, wenn nicht, warum.

Der Agent sucht von allein alle 15 Minuten nach neuen Druckern in deinem Netzwerk. Wenn du gerade einen eingeschaltet hast und nicht warten willst, klick auf Jetzt suchen unter Drucker im lokalen Netzwerk.

Eigenheiten, die man kennen sollte

Der Agent merkt sich, wer er ist. Seine Identität steht im Manifest (BP_AGENT_INSTANCE_ID), dasselbe Manifest auf einer anderen Maschine gestartet bleibt also derselbe Agent. Ändere sie nicht und kopiere sie nicht in eine andere Installation: sie ist sein Passwort. Agenten, die mit einem älteren Manifest ausgerollt wurden, speichern ihre Identität in ihrem Datenvolume; wenn du es löschst, musst du sie erneut freigeben (es geht nichts verloren).

Ein Agent verkraftet eine ganze Flotte. Du brauchst nicht einen pro Drucker oder einen pro Raum. Trotzdem kannst du mehrere Agenten im selben Konto haben, und es gibt drei Gründe dafür:

Getrennte Netzwerke: ein VLAN für die Produktion und eines fürs Büro, zum Beispiel. Ein Agent in jedem erkennt seine eigenen, ohne dass du etwas von Hand hinzufügen musst.
Verschiedene Standorte: zwei Hallen, zwei Werkstätten, zwei Häuser. Jeder Ort mit seinem eigenen, und in BolloPrint sieht man alles zusammen.
Ein überlasteter Agent: wenn die Flotte stark wächst und du merkst, dass es eng wird, verteil die Drucker auf zwei.

Jeder Agent wird gleich angelegt, mit eigenem Namen und eigenem Code. Im Tab Lokaler Agent siehst du sie untereinander, und unter Drucker im lokalen Netzwerk zeigt jede Maschine, über welchen Agenten sie kommt. Um einen Drucker von einem Agenten auf einen anderen umzuziehen, öffne ihn über Bearbeiten im Menü ⋮ und wähl im Auswahlfeld den anderen Agenten. Beim Per IP hinzufügen mit mehreren Agenten fragt er, welcher ihn steuern soll.

⚠️ Ein Code pro Rechner

Was du nicht tun solltest, ist denselben Code auf zwei Maschinen zu verwenden: die zweite wartet dann auf Freigabe, und wenn du sie freigibst, verliert die erste den Zugang. Für zwei Rechner: zwei Agenten.

Er übersteht Ausfälle. Wenn dein Internet ausfällt, liest der Agent die Drucker weiter aus und speichert, was passiert. Sobald die Verbindung zurück ist, schickt er alles. Die Stunden des Ausfalls gehen im Verlauf nicht verloren.

Schlüssel neu zu erzeugen trennt den Agenten sofort. Der vorherige Code und die vorherige Identität gelten nicht mehr, sobald du den Button drückst; der Agent ist also getrennt, bis du ihn mit dem neuen Manifest erneut ausrollst. Nutze das, wenn du glaubst, dass jemand deine Schlüssel hat, oder wenn du das Manifest verloren hast. Zum Aktualisieren des Agenten ist es nicht nötig: Es reicht, die Image-Version zu ändern (Den Agent aktualisieren).

Einen Agenten zu löschen nimmt seine Drucker mit. Das machst du über das Menü ⋮ seiner Zeile. Er verbindet sich sofort nicht mehr, und die Drucker, die nur über ihn erreichbar waren, verschwinden aus der Liste und zählen nicht mehr für deinen Tarif. Die, die auch über Bambu Cloud kommen, bleiben. Es geht nichts verloren: Fügst du einen dieser Drucker wieder hinzu — mit einem anderen Agenten, über die Erkennung oder per IP —, kommt er mit seiner Nummer und seinem ganzen Verlauf zurück. Der Container, der auf deinem Rechner läuft, wird nicht von BolloPrint aus gelöscht: Stoppe und entferne ihn selbst (docker compose down in seinem Ordner, oder lösche den Stack in Portainer).

Wenn etwas nicht läuft

Wenn der Agent nicht auftaucht oder sich seltsam verhält, schau zuerst in sein Protokoll auf dem Rechner, auf dem er läuft:

docker logs bolloprint_agent --tail 50

Symptom	Was zu prüfen ist
Der Agent taucht nie auf	Wurde der Code vollständig und ohne Leerzeichen davor oder dahinter eingefügt? Kommt der Rechner ins Internet? Blockiert eine Firewall den ausgehenden Verkehr?
Er verlangt bei jedem Neustart eine Freigabe	Das Manifest enthält kein `BP_AGENT_INSTANCE_ID` (es ist älter oder wurde von Hand bearbeitet). Erzeuge die Schlüssel neu und roll das neue Manifest unverändert aus.
Er erkennt keinen einzigen Drucker	Stehen Agent und Drucker im selben Netzwerk? Wenn nicht, oder wenn du Docker Desktop verwendest, ist das zu erwarten: füg sie über die IP hinzu, und sie funktionieren genauso.
Ein Drucker erscheint als „verbunden, sendet aber keine Daten"	Schließ die Handy-App oder den Slicer, die ihn offen haben. Manche Maschinen lassen nur eine Verbindung gleichzeitig zu.
Ein Drucker „antwortet, lehnt die Verbindung aber ab"	Falscher Zugangscode oder am Display der Maschine deaktivierter LAN-Modus. Achtung: bei Bambu ändert sich der Code jedes Mal, wenn du den LAN-Modus ein- oder ausschaltest.
Alle Drucker eines Agenten auf einmal getrennt	Es liegt nicht an der Flotte, sondern am Agenten. Öffne ihn mit Bearbeiten und sieh dir seinen Status an.

Häufige Fragen

Kann ich einen Druck aus BolloPrint heraus pausieren oder abbrechen? Ja, bei den über den Agenten verbundenen Maschinen, die es zulassen (derzeit Klipper, PrusaLink und die Elegoo, die über SDCP laufen: die Harzdrucker und die Centauri Carbon). Bei Bambu nicht, weder über den Agenten noch über die Cloud: Ihre Firmware ignoriert Befehle, die nicht aus ihren eigenen Programmen kommen. Was bei keiner geht, ist Aufträge zu senden: die Datei wird weiterhin aus deinem Slicer geschickt.

Was passiert, wenn in der Werkstatt das Internet ausfällt? Der Agent spricht weiter mit deinen Druckern und speichert, was geschieht. Sobald die Verbindung zurück ist, schickt er alles. Bei einem sehr langen Ausfall passt vielleicht nicht jedes Detail hinein, und in dem Fall sagt er es dir.

Speichert er etwas auf meiner Festplatte? Er speichert keine Druckdaten. In seinem Volume speichert er sein eigenes Aktivitätsprotokoll der letzten Tage, das sich von selbst löscht (und, bei Agenten, die mit einem älteren Manifest ausgerollt wurden, seine Identitätsdatei). Dieses Protokoll verlässt deinen Rechner nur, wenn der BolloPrint-Support es anfordert, um ein Problem zu untersuchen.

Wie viel verbraucht er? Sehr wenig: zwischen 10 und 20 MB Arbeitsspeicher bei mehreren verbundenen Druckern.

Und wenn ich den Rechner ausschalte? Nichts passiert. Beim Einschalten kommt der Agent von allein zurück, ohne dich um irgendetwas zu bitten.

Muss ich Ports im Router öffnen? Nein. Weder Ports noch feste IP noch Firewall-Regeln. Die Verbindung geht von deinem Netzwerk nach außen, wie wenn du eine Webseite aufrufst.