🚀 Den Agent ausrollen
Wie du einen lokalen Agenten zum ersten Mal startest: wo du ihn installierst, wie du ihn in BolloPrint anlegst und wie du ihn auf deinem Rechner startest. Läuft er schon, und weist dich BolloPrint auf eine neue Version hin, suchst du Den Agent aktualisieren.
Wo er hingehört
Auf irgendeinen Rechner in der Werkstatt, der immer eingeschaltet ist und im selben Netzwerk wie die Drucker steht:
- ein NAS (Synology, QNAP…),
- ein Mini-PC oder ein PC in der Werkstatt,
- ein Raspberry Pi,
- ein Server, den du ohnehin schon hast.
Er braucht Docker (oder Portainer, also Docker mit Oberfläche). Er verbraucht sehr wenig: zwischen 10 und 20 MB Arbeitsspeicher.
💡 Ideal ist, dass er im SELBEN Netzwerk steht wie die Drucker
Wenn der Agent in einem Netzwerk steht und die Drucker in einem anderen (getrennte VLANs, Gastnetzwerk, eigenes WLAN), hört er nicht auf zu funktionieren: verloren geht die automatische Erkennung, weil dieses „ich bin hier"-Signal nicht von einem Netzwerk ins andere kommt.
Die Drucker werden dann von Hand über ihre IP hinzugefügt und funktionieren genauso — mit allen Funktionen, egal welche Marke. Unverzichtbar ist nur, dass die beiden Netzwerke miteinander sprechen können (dass der Router oder die Firewall den Verkehr zwischen ihnen durchlässt).
Unter Docker Desktop (Windows und Mac) gibt es keine automatische Erkennung. Diese Systeme lassen den Container das Netzwerk des Rechners nicht sehen, deshalb müssen die Drucker von Hand über die IP hinzugefügt werden. Genau wie bei getrennten Netzwerken: sie funktionieren exakt gleich, es ist beim Anlegen nur ein Schritt mehr.
In BolloPrint anlegen
- Geh zu Einstellungen → Drucker und öffne den Tab Lokaler Agent.
- Drück auf Neuer Agent und gib ihm einen Namen, den du wiedererkennst. Besser wo er steht als was er ist: „Erdgeschoss", „Halle 2".
- Drück auf Agent anlegen.
- Im zweiten Schritt erscheint das Bereitstellungs-Manifest, in dem der Code des Agenten und seine Identität schon eingetragen sind. Wähl Docker Compose oder Kubernetes und drück auf Kopieren. Es gibt nichts zu ersetzen.
🔐 Die Schlüssel werden nur ein einziges Mal angezeigt
Kopier das Manifest in diesem Moment. Die Schlüssel laufen nicht ab, aber wir zeigen sie nicht noch einmal. Wenn du das Manifest verlierst, öffne den Agenten mit Bearbeiten und nutze unter Bereitstellung Schlüssel neu erzeugen.
Kopier den Block immer vom Bildschirm, nicht aus einer alten E-Mail oder einer Notiz: dort steht die Agentenversion, die gerade die richtige ist.
Auf deinem Rechner starten
Wähl die Variante, die du nutzt. Bei allen drei geht das Manifest unverändert hinein, ohne etwas anzufassen.
Docker Compose
- Leg einen Ordner für den Agenten an, zum Beispiel
bolloprint-agent. - Speicher darin das Manifest als
docker-compose.yml. - Starte ihn aus diesem Ordner:
docker compose up -d
Portainer
- Geh zu Stacks → Add stack und gib ihm einen Namen, zum Beispiel
bolloprint-agent. - Füg im Web editor das Docker Compose-Manifest unverändert ein.
- Drück auf Deploy the stack.
Kubernetes
- Speicher das Kubernetes-Manifest in einer Datei, zum Beispiel
bolloprint-agent.yaml. - Wende es an:
kubectl apply -f bolloprint-agent.yaml
Geh danach zurück zu BolloPrint und drück im Fenster des Agenten auf Speichern.
Prüfen, ob es funktioniert
In weniger als einer Minute erscheint der Agent im Tab Lokaler Agent als Online. Er fragt nicht nach einer Freigabe: diese Installation ist bereits freigegeben.
Erscheint er nicht, schau in sein Protokoll auf dem Rechner, auf dem er läuft:
docker logs bolloprint_agent --tail 50
| Was passiert | Was zu prüfen ist |
|---|---|
| Er erscheint nie | Wurde das ganze Manifest ohne Änderungen eingefügt? Kommt der Rechner ins Internet? Blockiert eine Firewall den ausgehenden Verkehr? |
| Er erscheint, verlangt aber eine Freigabe | Das Manifest enthält kein BP_AGENT_INSTANCE_ID (es wurde von Hand bearbeitet oder ist älter). Erzeuge die Schlüssel neu und roll das neue Manifest unverändert aus. |
| Er ist online, findet aber keine Drucker | Steht er in einem anderen Netzwerk als die Drucker, oder nutzt du Docker Desktop, ist das zu erwarten: füg sie mit Per IP hinzufügen hinzu. |
Im Router müssen keine Ports geöffnet werden, keine feste IP beantragt und nichts an der Firewall angepasst werden: der Agent ruft BolloPrint an, nicht umgekehrt.
Ist der Agent online, ist der nächste Schritt, deine Drucker zu verbinden: das findest du unter Drucker im lokalen Netzwerk.