Sommaire du manuel

🧩 L'agent local

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. Mettre en pause et annuler, non : Bambu n'accepte pas d'ordres de programmes tiers, quelle que soit la voie
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 Creality K1 avec Moonraker accessible ou toute machine sous Klipper	Oui
Vous avez des FlashForge Adventurer 5M, AD5X ou Creator 5	Oui
Vous ne voulez pas que vos imprimantes sortent sur internet	Oui. L'agent leur parle à l'intérieur de votre réseau

Installer l'agent et le maintenir à jour

Deux pages séparées, car ce sont deux moments différents :

🚀 Déployer l'agent — où le placer, comment le créer dans BolloPrint et comment le démarrer sur votre poste avec Docker Compose, Portainer ou Kubernetes.
🔄 Mettre à jour l'agent — quoi faire quand BolloPrint vous avertit qu'une nouvelle version est disponible. Il s'agit de changer un numéro et de redéployer.

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.

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.

Autoriser les installations

L'installation issue du manifeste que vous avez copié entre directement. Toute autre installation qui utilise ce même code attend votre feu vert : vous verrez un avertissement rouge au-dessus des onglets et, dans l'agent, sous État, l'installation dans Installations en attente d'autorisation, avec le nom du poste depuis lequel elle se connecte.

Avec un manifeste actuel, cela n'arrive presque jamais : l'identité est écrite dans le manifeste lui-même, vous pouvez donc changer l'agent de machine ou le réinstaller, il reste le même. C'est normal que cela arrive avec un agent plus ancien, déployé avec un manifeste sans identité, quand :

vous le déplacez sur une autre machine,
vous supprimez son volume de données et le recréez,
vous le réinstallez de zéro.

Appuyez sur Autoriser si vous reconnaissez le poste. En en autorisant un, le précédent perd son accès.

Si une installation en attente apparaît sans que ce soit vous qui l'ayez lancée, ne l'autorisez pas : cela signifie que quelqu'un d'autre a votre code. Ouvrez l'agent, utilisez Régénérer les clés dans Déploiement et redéployez-le avec le nouveau manifeste.

L'écran d'état

Dans l'onglet Agent local, il y a deux parties :

Les agents, un par ligne, avec 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 — le manifeste avec la version actuelle et Régénérer les clés.

Ce qui peut apparaître dans État :

Ce que vous voyez	Ce que cela signifie
En ligne	Il est connecté et au travail.
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. Cela se fait sur votre poste, pas depuis BolloPrint : changez la version de l'image dans votre fichier et redéployez. Étape par étape dans Mettre à jour l'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

L'agent se souvient de qui il est. Son identité est écrite dans le manifeste (BP_AGENT_INSTANCE_ID) : le même manifeste démarré sur une autre machine reste donc le même agent. Ne la changez pas et ne la copiez pas dans une autre installation : c'est son mot de passe. Les agents déployés avec un manifeste plus ancien gardent leur identité dans leur volume de données ; si vous l'effacez, vous devrez l'autoriser à nouveau (rien n'est perdu).

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.

Chaque agent se crée de la même façon, avec son nom et son propre code. 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 code par poste

Ce qu'il ne faut pas faire, c'est utiliser le même code sur deux machines : la seconde restera en attente d'autorisation, et si vous l'autorisez, la première perdra l'accès. Pour deux postes, deux agents.

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.

Régénérer les clés coupe l'agent sur-le-champ. Le code et l'identité précédents cessent d'être valables dès que vous appuyez sur le bouton : l'agent se déconnecte donc jusqu'à ce que vous le redéployiez avec le nouveau manifeste. Utilisez-le si vous pensez que quelqu'un a vos clés ou si vous avez perdu le manifeste. Pour mettre à jour l'agent, ce n'est pas nécessaire : il suffit de changer la version de l'image (Mettre à jour l'agent).

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. Le conteneur qui tourne sur votre poste ne se supprime pas depuis BolloPrint : arrêtez-le et supprimez-le vous-même (docker compose down dans son dossier, ou supprimez la stack dans Portainer).

Quand quelque chose cloche

Quand l'agent n'apparaît pas ou se comporte bizarrement, la première chose à faire est de regarder son journal sur le poste où il tourne :

docker logs bolloprint_agent --tail 50

Symptôme	Que regarder
L'agent n'apparaît jamais	Le code a-t-il bien été collé, entier et sans espaces avant ou après ? Le poste atteint-il internet ? Un pare-feu bloque-t-il la sortie ?
Il demande une autorisation à chaque redémarrage	Le manifeste ne contient pas `BP_AGENT_INSTANCE_ID` (il est ancien ou a été modifié à la main). Régénérez les clés et déployez le nouveau manifeste tel quel.
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.

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, PrusaLink et les Elegoo qui passent par SDCP : celles à résine et la Centauri Carbon). Sur les Bambu, non, ni via l'agent ni via le cloud : leur firmware ignore les ordres qui ne proviennent pas de leurs propres programmes. 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. Dans son volume, il conserve son propre journal d'activité des derniers jours, qui s'efface tout seul au fil du temps (et, pour les agents déployés avec un manifeste plus ancien, son fichier d'identité). Ce journal ne quitte votre poste que si l'assistance de BolloPrint le demande pour examiner un problème.

Combien consomme-t-il ? Très peu : entre 10 et 20 Mo de mémoire avec plusieurs imprimantes connectées.

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.