Inhalt des Handbuchs

🔌 Drucker über das lokale Netzwerk

Über das lokale Netzwerk spricht BolloPrint direkt in deiner Werkstatt mit deinen Druckern, ohne den Umweg über die Cloud irgendeines Herstellers. Dafür braucht es einen Vermittler in deinem Netzwerk: den lokalen Agenten.

Zu finden unter Einstellungen → Drucker, Tab Lokaler Agent.

Warum das der empfohlene Weg ist

Er funktioniert mit fast allen Marken. Bambu Lab, Prusa, Elegoo, FlashForge und die, in denen Klipper steckt (QIDI, Sovol, Voron, RatRig, Creality K1 mit erreichbarem Moonraker…). Die Einzelheiten je Modell findest du unter Kompatible Drucker.
Du kannst Befehle geben: den laufenden Druck pausieren, fortsetzen und abbrechen, bei den Maschinen, die es zulassen (bei Bambu nicht).
Du hast eine Kamera: ein Foto vom Innenraum alle paar Minuten, während gedruckt wird, und ein weiteres sofort, wenn du es auf der Druckerseite anforderst.
Es hängt nicht am Hersteller. Weder daran, ob seine Cloud läuft, noch daran, ob er seinen Dienst offen hält.
Es übersteht Internetausfälle. Wenn deine Verbindung ausfällt, liest der Agent die Drucker weiter aus und speichert, was passiert; sobald die Leitung zurück ist, schickt er alles. Du verlierst den Verlauf dieser Stunden nicht.

Der Agent öffnet dein Netzwerk für niemanden. Er ruft uns an, nicht umgekehrt — es müssen also keine Ports im Router geöffnet werden, keine feste IP her und nichts in der Firewall eingerichtet werden. Er funktioniert genauso hinter einem ganz normalen Heimrouter.

Die drei Schritte

Den Agenten anlegen in BolloPrint und sein Bereitstellungs-Manifest kopieren, in dem der Code schon steht.
Ihn auf einem Rechner in der Werkstatt ausrollen, der immer eingeschaltet ist.
Die Drucker anlegen, die er verwalten soll.

Schritt 2 ist unter Den Agent ausrollen ausführlich beschrieben. Hier machen wir mit Schritt 3 weiter.

Drucker hinzufügen

Die, die von allein auftauchen

Der Agent sucht Drucker in deinem Netzwerk, und die, die er findet, erscheinen im Tab Lokaler Agent, am Ende von Drucker im lokalen Netzwerk, unter Im Netzwerk gefunden (bei mehreren Agenten „Gefunden von" und dem Namen jedes einzelnen), mit ihrer Marke und ihrem Modell. Drück auf Hinzufügen, und fertig. Wenn er nicht dir gehört oder du ihn nicht willst: Ignorieren. Wenn es welche gibt, siehst du das auch in einem Hinweis über den Tabs.

Wenn es ein Drucker ist, den du schon über Bambu Cloud hast, steht das dabei („Das ist „P1S-02“, den du schon über Bambu Cloud hast“), und der Button heißt Auch per LAN verbinden: Es wird kein neuer Drucker angelegt, sondern dem vorhandenen der lokale Weg hinzugefügt.

Manche verlangen vor dem Verbinden einen Zugangscode; die Karte selbst weist dich darauf hin, wenn es so ist.

Es kann auch ein Drucker mit der Markierung Demnächst erscheinen: wir wissen, was er ist, können ihn aber noch nicht verbinden. Wenn du genau den brauchst, sag uns Bescheid — das hilft uns, die Reihenfolge festzulegen.

Die, die von Hand hinzugefügt werden müssen

Wenn der Drucker nicht auftaucht, drück auf Per IP hinzufügen unter Drucker im lokalen Netzwerk, im Tab Lokaler Agent. Hast du mehr als einen Agenten, fragt er dich, welcher ihn steuern soll. Dass er nicht auftaucht, ist in zwei Fällen normal: wenn der Agent in einem anderen Netzwerk steht als die Drucker, und wenn er unter Docker Desktop läuft. In keinem der beiden Fälle verlierst du etwas: von Hand hinzugefügt funktioniert er genauso, mit Kamera und mit Steuerung, sofern die Maschine sie hat.

Protokoll: der Typ des Druckers. Die Liste bietet nur die an, die wir verbinden können.
Adresse: die IP des Druckers. Wenn er einen anderen als den üblichen Port nutzt, schreib ihn dahinter: 192.168.1.50:5000.
Name (optional): der, den du ihm geben möchtest.
Modell: zum Beispiel „Saturn 4 Ultra" oder „MK4S". Füll es aus: Damit wissen wir, ob die Maschine mit Filament oder mit Harz arbeitet, und geben ihr das passende Datenblatt.
Das Passwort des Druckers, wenn diese Familie eines verlangt. Der Name des Feldes hängt vom Protokoll ab (siehe Tabelle).

Das Passwortfeld heißt so, wie jede Marke es nennt, und darunter steht, wo du es am Drucker findest. Das musst du eintragen:

Protokoll	Was du einträgst
Bambu Lab	Erscheint als LAN-Zugangscode. Es ist der, den der Drucker unter Einstellungen → Netzwerk → Zugangscode anzeigt, mit aktiviertem LAN-Modus.
PrusaLink	Erscheint als PrusaLink-Passwort. Der Drucker erzeugt es und zeigt es unter Einstellungen → Netzwerk → PrusaLink an. Es ist nicht das von Prusa Connect.
FlashForge	Erscheint als Prüfcode. Es ist der, der im Netzwerkmenü auf dem Display des Druckers erscheint, mit aktiviertem LAN Only.
Elegoo (lokales MQTT) — Centauri Carbon 2	Erscheint als Zugangscode (optional). Lass es leer, es sei denn, du hast am Display der Maschine einen Code gesetzt (Einstellungen → Netzwerk); dann trag diesen Code ein.
Klipper	Erscheint als API-Schlüssel (optional). Nur wenn du in deinem Klipper (Moonraker) einen Zugangsschlüssel eingerichtet hast. Hat der Drucker die Verbindung ohne Schlüssel abgelehnt, wird das Feld zu Moonraker-API-Schlüssel und ist Pflicht: Du findest ihn in Mainsail oder Fluidd unter Einstellungen → API key.
SDCP	Verlangt nichts.

Die Seriennummer ermittelt der Agent von allein. Du musst sie nicht eintippen.

💡 Reserviere die IP in deinem Router

Wenn der Router dem Drucker eine andere Adresse gibt, suchen wir ihn von allein neu in deinem Netzwerk, aber er ist eine Weile ausgefallen. Die IP per MAC zu reservieren — oder eine feste IP zu vergeben — vermeidet diese Lücke.

Einen Drucker bearbeiten oder entfernen

Unter Drucker im lokalen Netzwerk, im Tab Lokaler Agent, zeigt jeder Drucker, welcher Agent ihn steuert, und in seinem Menü ⋮ findest du:

Bearbeiten: den Namen, die Adresse, den Zugangscode oder den zuständigen Agenten ändern. Hierher kommst du auch aus dem Tab Drucker, über Lokale Verbindung bearbeiten im Menü der Maschine.
Trennen: Der Drucker ist nicht mehr über diesen Agenten verbunden.

Damit er nicht mehr für deinen Tarif zählt, ohne ihn zu entfernen, schalte ihn im Tab Drucker mit seinem Schalter ab.

Zu Trennen: Hatte er einen anderen Weg (zum Beispiel die Bambu-Cloud), läuft er darüber weiter. War es sein einziger Weg, steht er auf „Keine Verbindung" und zählt weiterhin zu deinem Tarif, bis du ihn deaktivierst oder löschst. Es geht nichts verloren: Er behält seine Nummer und seinen Verlauf, und wenn du ihn wieder verbindest, kommt er genau so zurück, auch wenn sich IP oder Code geändert haben.

Was jeder Status bedeutet

Status	Was gerade passiert
Online	Alles gut: der Agent sieht ihn und empfängt seine Daten.
Verbunden, sendet aber keine Daten	Der Agent hat sich verbunden, und der Drucker erzählt ihm nichts. Meist lässt die Maschine nur wenige gleichzeitige Verbindungen zu und hat schon eine offen (die Handy-App, der Slicer).
Antwortet unter dieser Adresse nicht	Prüfe, ob er eingeschaltet ist und im selben Netzwerk wie der Agent steht.
Antwortet, lehnt die Verbindung aber ab	Fast immer der falsche Zugangscode oder der am Drucker deaktivierte LAN-Modus.
Alle Drucker eines Agenten gleichzeitig getrennt	Das Problem liegt nicht an den Druckern: es ist ihr Agent, der nicht antwortet. Den Maschinen kann es bestens gehen. Öffne ihn im Tab Lokaler Agent mit Bearbeiten und sieh dir seinen Status an.

Hier geht es weiter

🧩 Der lokale Agent — wie er installiert wird (Den Agent ausrollen), wie er aktualisiert wird (Den Agent aktualisieren), wie er sich verbindet, wann sich mehr als einer lohnt und was zu tun ist, wenn etwas nicht klappt.
🔗 Verbindungsarten — was mit jeder Familie möglich ist.
🖨️ Kompatible Drucker — ob sich deiner verbinden lässt, und wie.