Inhalt des Handbuchs

🧩 Der lokale Agent

In 30 Sekunden

Der lokale Agent ist ein kleines Programm, das auf einem Rechner deiner Werkstatt läuft und deine Drucker über dein Netzwerk verbindet.
Er wird auf etwas installiert, das du schon eingeschaltet hast: ein NAS (Synology, QNAP, TrueNAS), ein Windows-PC, Home Assistant oder irgendein Rechner mit Docker oder Kubernetes. Unten siehst du, was zu dir passt.
Einer reicht für die ganze Flotte, und er ist es, der BolloPrint anruft: Es müssen keine Ports geöffnet werden, und du brauchst keine feste IP.
Er aktualisiert sich von allein, und fällt das Internet aus, speichert er, was passiert, und schickt es, sobald es zurück ist.

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. Und wenn du am Drucker den Entwicklermodus aktivierst, auch pausieren, fortsetzen und abbrechen: über die Cloud geht das nicht
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 Snapmaker U1 oder irgendeine Maschine mit Klipper	Ja
Du hast FlashForge Adventurer 5M, AD5X oder Creator 5	Ja
Du hast Anycubic Kobra 3, Kobra S1, Kobra 4 oder Kobra X	Ja. Mit aktiviertem LAN-Modus am Drucker (in der Beta)
Du hast einen Creality K1, K2, Ender-3 V3 oder Hi	Ja. Mit der Werksfirmware, ohne Vorbereitung (in der Beta)
Du willst nicht, dass deine Drucker ins Internet gehen	Ja. Der Agent spricht innerhalb deines Netzwerks mit ihnen

Wähl, wo du ihn installierst

Der Agent kommt auf einen Rechner in der Werkstatt, der immer eingeschaltet ist und möglichst im selben Netzwerk wie die Drucker steht. Du musst nichts kaufen: Fast immer reicht etwas, das du schon hast.

Es gibt zwei Arten, ihn zu installieren, und der Unterschied ist, wie er sich beim ersten Mal mit deinem Konto verbindet:

Mit einem Paket oder Installer (Synology, QNAP, Windows, Home Assistant, TrueNAS). Du installierst ihn wie jede andere Anwendung auf deinem Gerät, öffnest seine Seite und drückst auf Mit BolloPrint verknüpfen. Du bestätigst in BolloPrint, und fertig: Es gibt keine Codes zu kopieren.
Mit einem Container (Docker, Kubernetes). Du legst den Agenten in BolloPrint an, und wir geben dir ein Manifest, in dem seine Schlüssel schon stehen und das du auf deinem Rechner einfügst.

Wo	Was du brauchst	Wie er installiert wird	Stand
Synology	Ein Synology-NAS mit DSM	Paket, und Mit BolloPrint verknüpfen	Beta
QNAP	Ein QNAP-NAS mit QTS	Paket, das von Hand installiert wird, und Mit BolloPrint verknüpfen	Beta
Windows	Einen Windows-PC, den du nicht ausschaltest	Installer, und Mit BolloPrint verknüpfen	Beta
Home Assistant	Home Assistant mit seinem App-Store	Home-Assistant-App, und Mit BolloPrint verknüpfen	Beta
TrueNAS	Ein TrueNAS-NAS mit Apps	TrueNAS-App, und Mit BolloPrint verknüpfen	Beta
Docker	Irgendeinen Rechner mit Docker oder Portainer: ein NAS, ein Mini-PC, ein Raspberry Pi, ein Server	Manifest mit Schlüsseln	Stabil
Kubernetes	Einen Kubernetes-Cluster (k3s geht auch) mit einem Node im Netzwerk der Drucker	Manifest mit Schlüsseln	Stabil

Du schwankst zwischen zweien? Gibt es für deinen Rechner ein Paket, nimm das Paket: Es lässt sich mit weniger Schritten installieren und mit einem Klick verknüpfen. Docker ist die Wahl für alles andere, und die, die schon am längsten in Werkstätten läuft. Die mit Beta funktionieren, sind aber neu: Wenn etwas nicht so läuft, wie du erwartest, erzähl es uns über den Support.

Jede Seite erklärt die zwei Dinge, die du mit dem Agenten machen wirst: ihn beim ersten Mal installieren und ihn aktualisieren, falls wir dich einmal darum bitten.

💡 Der Anfang, in BolloPrint

Alle fangen an derselben Stelle an: Einstellungen → Drucker, Tab Lokaler Agent, Button Neuer Agent. Als Erstes fragt er Wo installierst du ihn?, mit einem Button für jede der Varianten aus dieser Tabelle.

Aktuell halten

Der Agent aktualisiert sich von allein: Erscheint eine neue Version, lädt er sie herunter, prüft, dass sie von uns stammt, und startet mit ihr neu. Das tut er nie, während einer seiner Drucker druckt.

Nur wenn dich BolloPrint darauf hinweist, dass dein Agent eine manuelle Aktualisierung braucht, musst du etwas tun, und das hängt davon ab, wie du ihn installiert hast:

Mit einem Paket oder Installer: Installier die neue Version über die, die du hast, ohne die alte zu deinstallieren.
Mit Docker oder Kubernetes: Ändere die Version des Images in deiner Datei und roll sie neu aus, mit denselben Schlüsseln.

Die Schritt-für-Schritt-Anleitung steht auf der Seite jeder Variante.

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.

Diagramm wird geladen…

Was BolloPrint dem Agenten sagt, läuft über dieselbe Verbindung, die er selbst geöffnet hat.

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.

Der Statusbildschirm

Im Tab Lokaler Agent gibt es zwei Bereiche:

Die Agenten, einer pro Zeile, mit dem Logo dessen, worauf er installiert ist, seinem Status und seiner 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 — bei Docker und Kubernetes das Manifest mit der aktuellen Version und Schlüssel neu erzeugen. Bei einem Agenten, der mit einem Paket installiert wurde, steht dort nur, dass er über seine eigene Seite verknüpft wurde: Er hat kein Manifest und keine Schlüssel. Zum Entfernen nimmst du Löschen im Menü ⋮ der Liste, und seine Seite bietet wieder Mit BolloPrint verknüpfen an.

Was unter Status erscheinen kann:

Was du siehst	Was es bedeutet
Online	Er ist verbunden und arbeitet.
Nicht installiert	Du hast ihn in BolloPrint angelegt, aber er hat sich noch nie verbunden. Es ist nichts kaputt: Du musst ihn nur noch auf deinem Rechner starten.
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. Neuere Agenten aktualisieren sich selbst; steht da, dass ein manuelles Update nötig ist, folg der Seite für deine Agentenvariante.

Darunter Verbindung zu jedem Drucker: Drucker für Drucker, ob der Agent ihn 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

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.

Sie müssen nicht von derselben Art sein: Du kannst einen auf dem Synology in der Halle und einen anderen in Docker im Büro haben. 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 Agent pro Rechner

Jeder Rechner bekommt seinen eigenen Agenten. Ein Docker- oder Kubernetes-Agent wird nicht mit demselben Manifest auf eine zweite Maschine kopiert: Für zwei Rechner brauchst du zwei Agenten. Was für jede Variante gilt, steht auf ihrer Seite.

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.

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 Plan. 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. Was auf deinem Rechner installiert ist, wird nicht von BolloPrint aus gelöscht: Ein Paket kehrt von allein zu seiner Seite Mit BolloPrint verknüpfen zurück, und einen Container stoppst und entfernst du selbst. Wie, steht auf der Seite jeder Variante.

Wenn etwas nicht läuft

Symptom	Was zu prüfen ist
Der Agent taucht nie auf	Kommt der Rechner ins Internet? Blockiert eine Firewall den ausgehenden Verkehr? Wurde bei Docker und Kubernetes das ganze Manifest ohne Änderungen eingefügt?
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.

Reicht das nicht, erklärt die Seite deiner Agentenvariante, wo du sein Protokoll findest: Das ist das Erste, worum wir dich im Support bitten werden.

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, Snapmaker, PrusaLink, die Elegoo, die über SDCP laufen — die Harzdrucker und die Centauri Carbon — und die Bambu mit aktiviertem Entwicklermodus). Dieser Modus setzt den LAN-Only-Modus voraus, der den Bambu von seiner Cloud trennt; ohne ihn ignoriert der Drucker den Befehl, und BolloPrint schaltet seine Schaltflächen ab, sobald er ihn ablehnt. Über die Cloud nehmen Bambu-Drucker keine Befehle an. Was bei keiner geht, ist Druckaufträ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. Er speichert sein eigenes Aktivitätsprotokoll der letzten Tage, das sich von selbst löscht, und die Versionen, die er für seine Aktualisierung herunterlädt. Dieses Protokoll verlässt deinen Rechner nur, wenn der BolloPrint-Support es anfordert, um ein Problem zu untersuchen.

Wie viel verbraucht er? Wenig: Er braucht keinen leistungsstarken Rechner und passt problemlos auf ein NAS oder einen Mini-PC, neben allem, was dort schon läuft. Bei Docker und Kubernetes begrenzt ihn das Manifest auf 512 MB Arbeitsspeicher.

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.

Kann ich später die Variante wechseln? Ja. Installier die neue, prüf, dass sie als Online erscheint, übertrag die Drucker auf sie (oder lass sie sie finden) und lösch die alte. Die Drucker behalten ihre Nummer und ihren Verlauf.