🏠 Agent sur Home Assistant

Si vous avez déjà un Home Assistant allumé jour et nuit à l'atelier, vous avez déjà où mettre l'agent : il tourne en permanence, il est sur votre réseau et il a sa propre boutique d'applications. Cette page explique comment l'y installer, l'associer à votre atelier et le garder à jour.

Si votre poste est autre chose (un NAS, un PC, un serveur avec Docker), choisissez le vôtre dans L'agent local, qui explique aussi ce que fait l'agent, quel que soit le poste.

---

Ce qu'il vous faut

• Home Assistant OS, qui est l'installation livrée avec une boutique d'applications. Les installations « Supervised » en ont une aussi, mais Home Assistant ne les maintient plus. Si votre Home Assistant tourne dans Docker (« Container »), il n'a pas d'applications : installez l'agent avec Docker, comme l'explique Agent sur Docker.
• Un appareil 64 bits : un mini-PC ou un PC Intel ou AMD, un Raspberry Pi 4 ou 5, ou un Home Assistant Green ou Yellow. Sur un Raspberry Pi 3 ou un système 32 bits, l'application ne peut pas s'installer.
• Que Home Assistant soit sur le même réseau que vos imprimantes. S'il tourne dans une machine virtuelle, son réseau doit être en mode pont (bridge), pas en NAT.
• Le port 8257 libre sur ce poste. Si quelque chose d'autre l'utilise, il se change en un instant (plus bas).
• Être propriétaire de l'atelier dans BolloPrint : l'agent ne peut être associé qu'à un atelier qui vous appartient.

---

L'installer

1. Depuis un ordinateur ou un téléphone connecté à votre réseau, ouvrez ce lien : Ajouter BolloPrint à mon Home Assistant. C'est une page de Home Assistant : la première fois, elle vous demande l'adresse de votre Home Assistant, par exemple http://homeassistant.local:8123.
2. Cliquez sur Open link. Votre Home Assistant vous demande si vous voulez ajouter le dépôt d'applications de BolloPrint : cliquez sur Ajouter.
3. La fiche de BolloPrint Agent s'ouvre, avec le chien de BolloPrint. Cliquez sur Installer. Home Assistant prépare l'application lui-même ; cela prend une ou deux minutes.
4. Cliquez sur Démarrer. Laissez Lancer au démarrage activé, pour que l'agent revienne tout seul à chaque redémarrage de Home Assistant.

---

L'associer à votre atelier

1. Dans la fiche de l'application, cliquez sur Ouvrir l'interface utilisateur web. La page de l'agent s'ouvre dans un nouvel onglet : elle indique qu'il n'appartient encore à aucun atelier et affiche un code, comme 8054-627E.
2. Cliquez sur Associer à BolloPrint. Vous arrivez sur BolloPrint ; connectez-vous avec votre compte s'il vous le demande.
3. Choisissez l'atelier, vérifiez que le code est le même que sur la page de l'agent, relisez le nom qu'il vous propose (celui de votre Home Assistant ; vous pouvez le changer) et confirmez.
4. Vous revenez sur la page de l'agent, qui indique maintenant « Associé à … ». En moins d'une minute, vous le verrez En ligne dans Paramètres → Imprimantes → Agent local, avec le logo de Home Assistant, et il commencera à chercher vos imprimantes.

Dans BolloPrint, il n'y a rien à créer avant. La carte Home Assistant de Nouvel agent se contente de vous rappeler ces étapes.

---

Le port de la page

La page de l'agent utilise le port 8257 de l'appareil Home Assistant. Si quelque chose d'autre l'utilise déjà, l'application s'arrête dès son démarrage et son onglet Journal indique address already in use. Pour le changer :

1. Dans la fiche de l'application, ouvrez l'onglet Configuration.
2. Dans Réseau, indiquez un autre numéro (par exemple 8364) et cliquez sur Enregistrer.
3. Home Assistant vous demande s'il doit redémarrer l'application : acceptez. Ouvrir l'interface utilisateur web vous mène désormais au nouveau port.

Changer le port ne dissocie pas l'agent : c'est toujours le même, avec ses imprimantes.

---

Le garder à jour

Deux choses se mettent à jour ici, et vous n'avez presque jamais rien à faire :

Quoi	Comment ça se met à jour
L'agent, ce qui parle avec vos imprimantes	Tout seul. Quand BolloPrint publie une nouvelle version, il la télécharge et l'installe lui-même.
L'application Home Assistant, ce qui lance l'agent	Quand Home Assistant vous signale une mise à jour de BolloPrint Agent, cliquez sur Mettre à jour dans sa fiche. Si vous activez Mise à jour automatique dans la fiche, il le fera tout seul.

Mettre à jour l'application ne dissocie pas l'agent. Son identité est conservée dans les données de l'application, qui sont aussi incluses dans les sauvegardes de Home Assistant.

---

Le changer d'appareil ou le réinstaller

• Si vous réinstallez l'application ou la mettez sur un autre Home Assistant, associez-la à nouveau : ce sera un nouvel agent. Ajoutez vos imprimantes avec lui (il les trouvera tout seul si elles sont sur son réseau, ou par IP) et elles passeront avec leur numéro et tout leur historique. Ensuite, supprimez l'ancien agent, qui se sera retrouvé sans imprimantes.
• Si vous restaurez sur le même Home Assistant une sauvegarde qui inclut l'application, l'agent revient tel quel, déjà associé.

---

Le désinstaller

1. Dans BolloPrint, allez dans Paramètres → Imprimantes → Agent local, ouvrez le menu ⋮ de l'agent et cliquez sur Supprimer. Les imprimantes qui n'arrivaient que par lui disparaissent de la liste ; si un jour vous les ajoutez à nouveau, elles reviennent avec leur historique.
2. En quelques secondes, la page de l'agent propose de nouveau Associer à BolloPrint. Si vous n'en voulez plus, dans la fiche de l'application dans Home Assistant, ouvrez le menu ⋮ et cliquez sur Désinstaller.
3. Si vous le souhaitez, retirez aussi le dépôt : Magasin d'applications → ⋮ → Dépôts, puis la corbeille à côté de BolloPrint.

Si vous désinstallez l'application sans supprimer l'agent avant, il reste dans BolloPrint comme Hors ligne. Supprimez-le depuis son menu ⋮.

---

Quand quelque chose ne va pas

Le premier réflexe, c'est l'onglet Journal de l'application dans Home Assistant : il raconte ce que fait l'agent et, s'il s'arrête, pourquoi.

Symptôme	Que faire
BolloPrint Agent n'apparaît pas dans le magasin	Dans Magasin d'applications, menu ⋮ → Rechercher des mises à jour, puis rechargez la page. Si vous n'avez pas Applications dans Paramètres, votre Home Assistant n'a pas d'applications : installez l'agent avec Docker.
Impossible de l'installer	Votre appareil est en 32 bits, comme un Raspberry Pi 3. L'application a besoin de 64 bits.
L'installation échoue en cours de route	Home Assistant télécharge l'agent au moment de l'installer : vérifiez qu'il a accès à internet et réessayez.
L'application s'arrête dès son démarrage	Regardez le Journal. S'il indique address already in use, le port est occupé : changez-le comme expliqué plus haut.
Ouvrir l'interface utilisateur web n'affiche rien	Vous êtes en dehors du réseau de l'atelier (accès à distance, VPN, données mobiles). Ouvrez-le depuis le réseau local.
Votre atelier n'apparaît pas lors de l'association	Vous ne pouvez associer l'agent qu'aux ateliers dont vous êtes propriétaire. Demandez au propriétaire de l'associer lui-même.
Il ne trouve aucune imprimante	Home Assistant est-il sur le même réseau qu'elles ? Dans une machine virtuelle, son réseau doit être en mode pont. Si elles sont sur des réseaux séparés, ajoutez-les par IP : elles fonctionnent pareil.
Vous l'avez supprimé dans BolloPrint et la page indique toujours « Associé »	Attendez une minute et rechargez : l'agent redémarre tout seul, sans association.