🧩 L'agent local
En 30 secondes
- L'agent local est un petit programme qui tourne sur un poste de votre atelier et connecte vos imprimantes via votre réseau.
- Il s'installe sur quelque chose que vous avez déjà allumé : un NAS (Synology, QNAP, TrueNAS), un PC sous Windows, Home Assistant, ou n'importe quel poste avec Docker ou Kubernetes. Vous trouverez plus bas celui qui vous convient.
- Un seul suffit pour toute la flotte, et c'est lui qui appelle BolloPrint : aucun port à ouvrir ni IP fixe nécessaire.
- Il se met à jour tout seul, et si internet tombe, il garde ce qui se passe et l'envoie au retour de la connexion.
L'agent local est un petit programme qui tourne sur un poste de votre atelier. Il parle à vos imprimantes via le réseau local et raconte à BolloPrint ce qu'il voit.
C'est la seule chose à installer pour connecter des imprimantes par réseau local, et un seul suffit pour toute la flotte.
En avez-vous besoin ?
| Votre situation | L'agent vous est-il nécessaire ? |
|---|---|
| Vous avez des Bambu Lab et les voir via le cloud vous suffit | Non, mais avec l'agent vous gagnez la caméra. Et, si vous activez le Mode développeur sur l'imprimante, aussi mettre en pause, reprendre et annuler : via le cloud, ce n'est pas possible |
| Vous avez des Prusa | Oui. C'est la seule façon de les connecter |
| Vous avez des Elegoo à résine ou une Centauri | Oui. Il n'y a pas d'autre voie |
| Vous avez des QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, une Snapmaker U1 ou toute machine sous Klipper | Oui |
| Vous avez des FlashForge Adventurer 5M, AD5X ou Creator 5 | Oui |
| Vous avez des Anycubic Kobra 3, Kobra S1, Kobra 4 ou Kobra X | Oui. Avec le Mode LAN activé sur l'imprimante (en bêta) |
| Vous avez une Creality K1, K2, Ender-3 V3 ou Hi | Oui. Avec son firmware d'usine, rien à préparer (en bêta) |
| Vous ne voulez pas que vos imprimantes sortent sur internet | Oui. L'agent leur parle à l'intérieur de votre réseau |
Choisissez où l'installer
L'agent se place sur un poste de l'atelier qui reste toujours allumé et, si possible, sur le même réseau que les imprimantes. Pas besoin d'acheter quoi que ce soit : presque toujours, quelque chose que vous avez déjà fait l'affaire.
Il y a deux façons de l'installer, et la différence tient à la manière dont il se relie à votre compte la première fois :
- Avec un paquet ou un installateur (Synology, QNAP, Windows, Home Assistant, TrueNAS). Vous l'installez comme n'importe quelle autre application de votre poste, vous ouvrez sa page et vous appuyez sur Associer à BolloPrint. Vous confirmez dans BolloPrint et c'est tout : aucun code à copier.
- Avec un conteneur (Docker, Kubernetes). Vous créez l'agent dans BolloPrint et nous vous donnons un manifeste avec ses clés déjà insérées, que vous collez sur votre poste.
| Où | Ce dont vous avez besoin | Comment il s'installe | État |
|---|---|---|---|
| Synology | Un NAS Synology sous DSM | Paquet, puis Associer à BolloPrint | Bêta |
| QNAP | Un NAS QNAP sous QTS | Paquet installé à la main, puis Associer à BolloPrint | Bêta |
| Windows | Un PC sous Windows que vous n'éteignez pas | Installateur, puis Associer à BolloPrint | Bêta |
| Home Assistant | Home Assistant avec sa boutique d'applications | Application Home Assistant, puis Associer à BolloPrint | Bêta |
| TrueNAS | Un NAS TrueNAS avec Apps | Application TrueNAS, puis Associer à BolloPrint | Bêta |
| Docker | N'importe quel poste avec Docker ou Portainer : un NAS, un mini-PC, un Raspberry Pi, un serveur | Manifeste avec clés | Stable |
| Kubernetes | Un cluster Kubernetes (k3s convient aussi) avec un nœud sur le réseau des imprimantes | Manifeste avec clés | Stable |
Vous hésitez entre deux ? Si votre poste a un paquet, utilisez le paquet : il s'installe en moins d'étapes et s'associe en un clic. Docker est l'option pour tout le reste, et celle qui tourne depuis le plus longtemps dans les ateliers. Celles marquées Bêta fonctionnent, mais elles sont nouvelles : si quelque chose ne se passe pas comme prévu, dites-le-nous au support.
Chaque page explique les deux choses que vous ferez avec l'agent : l'installer la première fois et le mettre à jour si un jour nous vous le demandons.
💡 Pour commencer, dans BolloPrint
Toutes commencent au même endroit : Paramètres → Imprimantes, onglet Agent local, bouton Nouvel agent. La première chose qu'il vous demande, c'est Où allez-vous l'installer ?, avec un bouton pour chacune des options de ce tableau.
Le maintenir à jour
L'agent se met à jour tout seul : quand une nouvelle version sort, il la télécharge, vérifie qu'elle vient bien de nous et redémarre avec elle. Il ne le fait jamais pendant qu'une de ses imprimantes est en train d'imprimer.
Ce n'est que si BolloPrint vous avertit que votre agent a besoin d'une mise à jour manuelle que vous devrez faire quelque chose, et cela dépend de la façon dont vous l'avez installé :
- Avec un paquet ou un installateur : installez la nouvelle version par-dessus celle que vous avez, sans désinstaller l'ancienne.
- Avec Docker ou Kubernetes : changez la version de l'image dans votre fichier et redéployez-le, avec les mêmes clés.
La marche à suivre se trouve sur la page de chaque type.
Comment il se connecte
L'agent appelle BolloPrint, et non l'inverse. C'est ce qui lui permet de fonctionner sans toucher au routeur : aucun port à ouvrir, aucune IP fixe à demander, rien à changer dans le pare-feu. Il fonctionne derrière un routeur domestique ordinaire, et même avec les connexions fibre qui ne fournissent pas d'IP publique.
Chargement du diagramme…
Ce que BolloPrint dit à l'agent passe par cette même connexion, ouverte par l'agent.
Une fois connecté :
- il demande quelles imprimantes il doit prendre en charge,
- il se connecte à chacune par son protocole,
- et il envoie au fil de l'eau ce qu'il voit.
Lorsque vous enregistrez une nouvelle imprimante depuis BolloPrint, l'agent l'apprend tout seul, en quelques secondes. Il n'y a pas à le redémarrer.
L'écran d'état
Dans l'onglet Agent local, il y a deux parties :
- Les agents, un par ligne, avec le logo de l'endroit où il est installé, leur état et leur version. Dans le menu ⋮ de chacun, vous avez Modifier, qui ouvre sa fenêtre, et Supprimer.
- Imprimantes sur le réseau local, en dessous : celles de tous vos agents réunies, chacune avec l'agent qui la pilote. En haut, Chercher maintenant et Ajouter par IP, et à la fin ce que chaque agent a trouvé sur votre réseau et les adresses qu'il cherche encore.
La fenêtre d'un agent comporte deux onglets :
- État — ce que l'agent rapporte lui-même (le tableau ci-dessous), les installations en attente et la liaison avec chaque imprimante. C'est aussi ici que vous changez son nom.
- Déploiement — sur Docker et Kubernetes, le manifeste avec la version actuelle et Régénérer les clés. Sur un agent installé avec un paquet, il indique seulement qu'il a été associé depuis sa page : il n'a ni manifeste ni clés. Pour le retirer, utilisez Supprimer dans le menu ⋮ de la liste, et sa page propose à nouveau Associer à BolloPrint.
Ce qui peut apparaître dans État :
| Ce que vous voyez | Ce que cela signifie |
|---|---|
| En ligne | Il est connecté et au travail. |
| Non installé | Vous l'avez créé dans BolloPrint, mais il ne s'est encore jamais connecté. Rien n'est cassé : il reste à le démarrer sur votre poste. |
| Pas de signal récent | Il n'a rien signalé depuis un moment. C'est généralement le poste éteint ou sans internet. |
| Hors ligne | Il n'est pas là. |
| Mode sécurisé | Il a démarré et s'est connecté, mais il ne gère pas d'imprimantes. Il vous en indique la raison. |
| Tampon | Ce qu'il a mis de côté pendant qu'il ne pouvait pas l'envoyer. Si « messages abandonnés » apparaît, c'est qu'il y a eu une coupure si longue que tout n'a pas tenu. |
| Mettez à jour votre agent | Il existe une version plus récente. Les agents récents se mettent à jour tout seuls ; s'il indique qu'une mise à jour manuelle est nécessaire, suivez la page de votre type d'agent. |
En dessous, Liaison avec chaque imprimante : machine par machine, si l'agent l'atteint et, si non, pourquoi.
L'agent recherche tout seul de nouvelles imprimantes sur votre réseau toutes les 15 minutes. Si vous venez d'en allumer une et que vous ne voulez pas attendre, appuyez sur Chercher maintenant dans Imprimantes sur le réseau local.
Particularités qu'il vaut mieux connaître
Un agent tient une flotte entière. Pas besoin d'un par imprimante ni d'un par salle. Cela dit, vous pouvez avoir plusieurs agents sur le même compte, et il y a trois raisons de le faire :
- Réseaux séparés : un VLAN pour la production et un autre pour le bureau, par exemple. Un agent dans chacun découvre les siennes sans que vous ayez à ajouter quoi que ce soit à la main.
- Locaux différents : deux ateliers, deux hangars, deux maisons. Chaque site avec le sien, et tout se voit ensemble dans BolloPrint.
- Un agent saturé : si la flotte grandit beaucoup et que vous le sentez juste, répartissez les imprimantes entre deux.
Ils n'ont pas besoin d'être du même type : vous pouvez en avoir un sur le Synology de l'atelier et un autre sur Docker au bureau. Dans l'onglet Agent local, vous les verrez les uns sous les autres, et dans Imprimantes sur le réseau local chaque machine indique par quel agent elle arrive. Pour déplacer une imprimante d'un agent à un autre, ouvrez-la avec Modifier dans son menu ⋮ et changez l'agent dans le menu déroulant. Avec Ajouter par IP et plusieurs agents, il vous demande lequel doit la piloter.
⚠️ Un agent par poste
Chaque poste a son propre agent. Un agent Docker ou Kubernetes ne se copie pas sur une deuxième machine avec le même manifeste : pour deux postes, deux agents. Ce qui concerne chaque type se trouve sur sa page.
Il survit aux coupures. Si votre internet tombe, l'agent continue de lire les imprimantes et d'enregistrer ce qui se passe. Au retour de la connexion, il envoie tout. Les heures de la coupure ne disparaissent pas de l'historique.
Supprimer un agent emporte ses imprimantes. Cela se fait depuis le menu ⋮ de sa ligne. Il cesse de se connecter sur-le-champ, et les imprimantes qui n'arrivaient que par lui disparaissent de la liste et ne comptent plus pour votre forfait. Celles qui arrivent aussi par Bambu Cloud restent. Rien n'est perdu : si vous ajoutez à nouveau l'une de ces imprimantes — avec un autre agent, par découverte ou par IP —, elle revient avec son numéro et tout son historique. Ce qui est installé sur votre poste ne se supprime pas depuis BolloPrint : un paquet revient de lui-même à sa page Associer à BolloPrint, et un conteneur, c'est vous qui l'arrêtez et le supprimez. La marche à suivre se trouve sur la page de chaque type.
Quand quelque chose cloche
| Symptôme | Que regarder |
|---|---|
| L'agent n'apparaît jamais | Le poste atteint-il internet ? Un pare-feu bloque-t-il la sortie ? Sur Docker et Kubernetes, le manifeste a-t-il été collé en entier, sans modification ? |
| Il ne détecte aucune imprimante | L'agent et les imprimantes sont-ils sur le même réseau ? Si ce n'est pas le cas, ou si vous utilisez Docker Desktop, c'est le comportement attendu : ajoutez-les par IP et elles fonctionneront pareil. |
| Une imprimante apparaît « connectée mais sans envoyer de données » | Fermez l'application mobile ou le trancheur qui la tient ouverte. Certaines machines n'acceptent qu'une seule connexion à la fois. |
| Une imprimante « répond mais refuse la connexion » | Code d'accès erroné, ou mode LAN désactivé sur l'écran de la machine. Attention : sur les Bambu, le code change chaque fois que vous activez ou désactivez le mode LAN. |
| Toutes les imprimantes d'un agent déconnectées d'un coup | Ce n'est pas la flotte, c'est l'agent. Ouvrez-le avec Modifier et regardez son État. |
Si cela ne suffit pas, la page de votre type d'agent explique où consulter son journal, qui est la première chose que nous vous demanderons au support.
Questions fréquentes
Puis-je mettre en pause ou annuler une impression depuis BolloPrint ? Oui, sur les machines connectées via l'agent qui le permettent (aujourd'hui, Klipper, Snapmaker, PrusaLink, les Elegoo qui passent par SDCP — celles à résine et la Centauri Carbon — et les Bambu avec le Mode développeur activé). Ce mode exige le Mode LAN Only, qui déconnecte la Bambu de son cloud ; sans lui, l'imprimante ignore l'ordre, et BolloPrint désactive ses boutons dès qu'elle le refuse. Via le cloud, les Bambu n'acceptent pas d'ordres. Ce qui n'est possible sur aucune, c'est d'envoyer des travaux : le fichier continue d'être envoyé depuis votre trancheur.
Que se passe-t-il si internet tombe dans l'atelier ? L'agent continue de parler à vos imprimantes et enregistre ce qui se passe. Au retour de la connexion, il envoie tout. Si la coupure est très longue, il se peut que le détail complet ne tienne pas, et dans ce cas il vous le dit.
Enregistre-t-il quelque chose sur mon disque ? Il n'enregistre pas de données d'impression. Il conserve son propre journal d'activité des derniers jours, qui s'efface tout seul au fil du temps, et les versions qu'il télécharge pour se mettre à jour. Ce journal ne quitte votre poste que si l'assistance de BolloPrint le demande pour examiner un problème.
Combien consomme-t-il ? Peu : il n'a pas besoin d'une machine puissante et tient largement sur un NAS ou un mini-PC, à côté de ce que vous y faites déjà tourner. Sur Docker et Kubernetes, le manifeste le limite à 512 Mo de mémoire.
Et si j'éteins le poste ? Rien de grave. En le rallumant, l'agent revient tout seul et sans rien vous demander.
Dois-je ouvrir des ports sur le routeur ? Non. Ni ports, ni IP fixe, ni règles de pare-feu. La connexion sort de votre réseau vers l'extérieur, comme lorsque vous ouvrez une page web.
Puis-je changer de type plus tard ? Oui. Installez le nouveau, vérifiez qu'il apparaît En ligne, passez-lui les imprimantes (ou laissez-le les trouver) et supprimez l'ancien. Les imprimantes conservent leur numéro et leur historique.