🧩 De lokale agent

De lokale agent is een klein programma dat op een computer in je werkplaats draait. Hij praat via je eigen netwerk met je printers en vertelt BolloPrint wat hij ziet.

Het is het enige wat je moet installeren om printers via het lokale netwerk te koppelen, en één is genoeg voor de hele vloot.

---

Heb je hem nodig?

Jouw situatie	Heb je de agent nodig?
Je hebt Bambu Lab en het is genoeg om ze via de cloud te zien	Nee, maar met de agent krijg je er een camera bij. En als je op de printer de ontwikkelaarsmodus aanzet, ook pauzeren, hervatten en annuleren: via de cloud kan dat niet
Je hebt Prusa	Ja. Het is de enige manier om ze te koppelen
Je hebt een Elegoo-harsprinter of een Centauri	Ja. Er is geen andere route
Je hebt QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, een Snapmaker U1 of een andere machine met Klipper	Ja
Je hebt een FlashForge Adventurer 5M, AD5X of Creator 5	Ja
Je hebt een Anycubic Kobra 3, Kobra S1, Kobra 4 of Kobra X	Ja. Met de LAN-modus aan op de printer (in bèta)
Je hebt een Creality K1, K2, Ender-3 V3 of Hi	Ja. Met de fabrieksfirmware, zonder voorbereiding (in bèta)
Je wilt niet dat je printers het internet op gaan	Ja. De agent praat binnen je netwerk met ze

---

Kies waar je hem installeert

De agent komt op een computer in de werkplaats die altijd aan staat en, als het kan, in hetzelfde netwerk als de printers zit. Je hoeft niets te kopen: bijna altijd volstaat iets wat je al hebt.

Er zijn twee manieren om hem te installeren, en het verschil is hoe hij de eerste keer met je account verbinding maakt:

• Met een pakket of een installatieprogramma (Synology, QNAP, Windows, Home Assistant, TrueNAS). Je installeert hem zoals elke andere app op je apparaat, opent zijn pagina en klikt op Koppelen met BolloPrint. Je bevestigt in BolloPrint en klaar: geen codes om te kopiëren.
• Met een container (Docker, Kubernetes). Je maakt de agent aan in BolloPrint en wij geven je een manifest met zijn sleutels er al in, dat je op je computer plakt.

Waar	Wat je nodig hebt	Hoe je hem installeert	Status
Synology	Een Synology-NAS met DSM	Pakket, en Koppelen met BolloPrint	Bèta
QNAP	Een QNAP-NAS met QTS	Pakket dat je handmatig installeert, en Koppelen met BolloPrint	Bèta
Windows	Een pc met Windows die je niet uitzet	Installatieprogramma, en Koppelen met BolloPrint	Bèta
Home Assistant	Home Assistant met zijn appwinkel	App voor Home Assistant, en Koppelen met BolloPrint	Bèta
TrueNAS	Een TrueNAS-NAS met Apps	App voor TrueNAS, en Koppelen met BolloPrint	Bèta
Docker	Elke computer met Docker of Portainer: een NAS, een mini-pc, een Raspberry Pi, een server	Manifest met sleutels	Stabiel
Kubernetes	Een Kubernetes-cluster (k3s is ook goed) met een node in het netwerk van de printers	Manifest met sleutels	Stabiel

Twijfel je tussen twee? Heeft je apparaat een pakket, gebruik dan het pakket: het installeert met minder stappen en koppelt met één klik. Docker is de optie voor al het andere, en degene die al het langst in werkplaatsen draait. De opties met Bèta werken, maar zijn nieuw: gaat er iets niet zoals je verwacht, laat het ons dan weten via support.

Elke pagina legt de twee dingen uit die je met de agent gaat doen: hem de eerste keer installeren en hem bijwerken als we je daar ooit om vragen.

---

Hem bijhouden

De agent werkt zichzelf bij: komt er een nieuwe versie uit, dan downloadt hij die, controleert hij dat die van ons is en herstart hij ermee. Dat doet hij nooit terwijl een van zijn printers aan het printen is.

Alleen als BolloPrint je laat weten dat je agent een handmatige update nodig heeft, moet je iets doen, en dat hangt af van hoe je hem hebt geïnstalleerd:

• Met een pakket of een installatieprogramma: installeer de nieuwe versie over de versie heen die je hebt, zonder de vorige te verwijderen.
• Met Docker of Kubernetes: pas de versie van de image in je bestand aan en installeer opnieuw, met dezelfde sleutels.

Het stappenplan staat op de pagina van elk type.

---

Hoe hij verbinding maakt

De agent belt BolloPrint, niet andersom. Daardoor werkt hij zonder dat je aan de router hoeft te komen: geen poorten openzetten, geen vast IP-adres aanvragen, niets in de firewall. Hij werkt achter een gewone thuisrouter, en zelfs met glasvezelverbindingen die geen publiek IP-adres geven.

Diagram laden…

Wat BolloPrint de agent vertelt, gaat over diezelfde verbinding die hij zelf heeft geopend.

Zodra hij verbonden is:

• vraagt hij welke printers hij moet bedienen,
• maakt hij met elke printer verbinding via het bijbehorende protocol,
• en stuurt hij door wat hij ziet.

Voeg je in BolloPrint een nieuwe printer toe, dan weet de agent dat vanzelf, binnen enkele seconden. Je hoeft hem niet te herstarten.

---

Het statusscherm

Het tabblad Lokale agent heeft twee delen:

• De agents, één per regel, met het logo van waar hij geïnstalleerd is, zijn status en zijn versie. In het menu ⋮ van elke agent heb je Bewerken, dat zijn venster opent, en Verwijderen.
• Printers op het lokale netwerk, daaronder: de printers van al je agents samen, elk met de agent die hem aanstuurt. Bovenaan staan Nu zoeken en Toevoegen via IP, en onderaan wat elke agent in je netwerk heeft gevonden en de adressen die hij nog aan het zoeken is.

Het venster van een agent heeft twee tabbladen:

• Status — wat de agent zelf meldt (de tabel hieronder), de wachtende installaties en de verbinding met elke printer. Hier verander je ook zijn naam.
• Installatie — bij Docker en Kubernetes het manifest met de huidige versie en Sleutels opnieuw genereren. Bij een agent die met een pakket is geïnstalleerd staat er alleen dat hij vanaf zijn eigen pagina is gekoppeld: hij heeft geen manifest en geen sleutels. Om hem weg te halen gebruik je Verwijderen in het menu ⋮ van de lijst, en zijn pagina biedt dan weer Koppelen met BolloPrint aan.

Wat er bij Status kan verschijnen:

Wat je ziet	Wat het betekent
Online	Hij is verbonden en aan het werk.
Niet geïnstalleerd	Je hebt hem in BolloPrint aangemaakt, maar hij heeft nog nooit verbinding gemaakt. Er is niets kapot: je moet hem nog op je computer starten.
Geen recent signaal	Hij heeft al een tijdje niets van zich laten horen. Meestal staat de computer uit of heeft hij geen internet.
Offline	Hij is er niet.
Veilige modus	Hij is opgestart en verbonden, maar beheert geen printers. Hij vertelt je de reden.
Buffer	Wat hij heeft bewaard terwijl hij het niet kon versturen. Staat er “berichten verworpen”, dan was er een storing die zo lang duurde dat niet alles paste.
Werk je agent bij	Er is een nieuwere versie. Recente agents werken zichzelf bij; staat er dat je met de hand moet bijwerken, volg dan de pagina van jouw type agent.

Daaronder Verbinding met elke printer: machine per machine, of de agent erbij kan en, zo niet, waarom.

De agent zoekt zelf elke 15 minuten naar nieuwe printers in je netwerk. Heb je er net een aangezet en wil je niet wachten, klik dan op Nu zoeken in Printers op het lokale netwerk.

---

Eigenaardigheden die je goed kunt weten

Eén agent kan een hele vloot aan. Je hebt er niet één per printer of één per ruimte nodig. Dat gezegd hebbende, kun je meerdere agents in hetzelfde account hebben, en er zijn drie redenen om dat te doen:

• Gescheiden netwerken: bijvoorbeeld een VLAN voor de productie en een voor het kantoor. Een agent in elk netwerk vindt zijn eigen printers, zonder dat je iets met de hand hoeft toe te voegen.
• Verschillende locaties: twee hallen, twee werkplaatsen, twee huizen. Elke locatie zijn eigen agent, en in BolloPrint zie je alles samen.
• Een overbelaste agent: groeit de vloot flink en merk je dat hij het krap heeft, verdeel de printers dan over twee.

Ze hoeven niet van hetzelfde type te zijn: je kunt er een op de Synology in de hal hebben en een in Docker op kantoor. Op het tabblad Lokale agent zie je ze onder elkaar, en in Printers op het lokale netwerk staat bij elke machine via welke agent hij binnenkomt. Om een printer van de ene agent naar de andere te verplaatsen, open je hem met Bewerken in zijn menu ⋮ en kies je een andere agent in de keuzelijst. Bij Toevoegen via IP met meerdere agents wordt gevraagd welke hem aanstuurt.

Overleeft storingen. Valt je internet weg, dan blijft de agent de printers lezen en bewaren wat er gebeurt. Zodra de verbinding terug is, stuurt hij alles door. De uren van de storing ontbreken niet in de geschiedenis.

Een agent verwijderen neemt zijn printers mee. Dat doe je vanuit het menu ⋮ van zijn regel. Hij maakt meteen geen verbinding meer, en de printers die alleen via hem binnenkwamen verdwijnen uit de lijst en tellen niet meer mee voor je abonnement. De printers die ook via Bambu Cloud binnenkomen blijven. Er gaat niets verloren: voeg je een van die printers opnieuw toe — met een andere agent, door hem te laten vinden of via IP —, dan komt hij terug met zijn nummer en zijn hele geschiedenis. Wat er op je computer geïnstalleerd is, wordt niet vanuit BolloPrint verwijderd: een pakket keert vanzelf terug naar zijn pagina met Koppelen met BolloPrint, en een container stop en verwijder je zelf. Hoe, staat op de pagina van elk type.

---

Als er iets niet werkt

Symptoom	Wat je controleert
De agent verschijnt nooit	Kan de computer bij internet? Blokkeert een firewall het uitgaande verkeer? Is bij Docker en Kubernetes het hele manifest geplakt, zonder wijzigingen?
Hij vindt geen enkele printer	Zitten de agent en de printers op hetzelfde netwerk? Zo niet, of als je Docker Desktop gebruikt, is dat te verwachten: voeg ze toe via IP en ze werken net zo goed.
Een printer staat op “verbonden maar stuurt geen gegevens”	Sluit de app op je telefoon of de slicer die hem open heeft. Sommige machines laten maar één verbinding tegelijk toe.
Een printer “reageert, maar weigert de verbinding”	Verkeerde toegangscode, of de LAN-modus staat uit op het scherm van de machine. Let op: bij Bambu verandert de code elke keer dat je de LAN-modus aan- of uitzet.
Alle printers van één agent ineens niet verbonden	Het is niet de vloot, het is de agent. Open hem met Bewerken en kijk naar zijn Status.

Is dat niet genoeg, dan legt de pagina van jouw type agent uit waar je zijn log vindt, en dat is het eerste waar we via support om vragen.

---

Veelgestelde vragen

Kan ik een print vanuit BolloPrint pauzeren of annuleren? Ja, op machines die via de agent gekoppeld zijn en het toestaan (nu Klipper, Snapmaker, PrusaLink, de Elegoo's die via SDCP werken — de harsprinters en de Centauri Carbon — en de Bambu's met de ontwikkelaarsmodus aan). Die modus vereist de LAN-only-modus, die de Bambu loskoppelt van zijn cloud; zonder die modus negeert de printer de opdracht, en BolloPrint schakelt zijn knoppen uit zodra hij hem weigert. Via de cloud accepteren de Bambu's geen opdrachten. Wat bij geen enkele kan, is opdrachten versturen: het bestand stuur je nog steeds vanuit je slicer.

Wat gebeurt er als internet in de werkplaats wegvalt? De agent blijft met je printers praten en bewaart wat er gebeurt. Zodra de verbinding terug is, stuurt hij alles door. Duurt de storing extreem lang, dan past misschien niet alles in detail, en in dat geval laat hij je dat weten.

Bewaart hij iets op mijn schijf? Hij bewaart geen printgegevens. Hij bewaart zijn eigen activiteitenlog van de laatste dagen, dat zichzelf opruimt, en de versies die hij downloadt om zichzelf bij te werken. Dat log verlaat je computer alleen als de support van BolloPrint erom vraagt om een probleem te onderzoeken.

Hoeveel verbruikt hij? Weinig: hij heeft geen krachtige computer nodig en past ruim op een NAS of mini-pc, naast wat daar al draait. Bij Docker en Kubernetes beperkt het manifest hem tot 512 MB geheugen.

En als ik de computer uitzet? Er gebeurt niets. Als je hem weer aanzet, komt de agent vanzelf terug, zonder iets te vragen.

Moet ik poorten in de router openzetten? Nee. Geen poorten, geen vast IP-adres en geen firewallregels. De verbinding gaat van je netwerk naar buiten, zoals wanneer je een webpagina opent.

Kan ik later van type wisselen? Ja. Installeer de nieuwe, controleer dat hij op Online staat, zet de printers over naar hem (of laat hem ze vinden) en verwijder de oude. De printers houden hun nummer en hun geschiedenis.