💾 Agent sur TrueNAS

Si vous avez un TrueNAS à l'atelier, vous avez déjà où mettre l'agent local : il est allumé toute la journée et sur le même réseau que vos imprimantes. L'agent tourne comme une app TrueNAS de plus, à côté de celles que vous avez déjà.

Cette page explique comment l'installer, l'associer à votre atelier, le mettre à jour, le déplacer et le retirer. Ce qu'est l'agent et quelles imprimantes il connecte, vous le trouverez dans L'agent local.

---

Avant de commencer

Ce qu'il vous faut	Comment le vérifier
TrueNAS 24.10 ou ultérieur (Community Edition)	Dans TrueNAS, Dashboard → System Information → Version. Les versions antérieures n'ont pas Install via YAML.
Les apps de TrueNAS activées	Dans Apps, en haut, s'affiche Apps Service Running. Si c'est la première fois, TrueNAS vous demande de choisir le pool où les enregistrer.
Vous connecter à TrueNAS avec un utilisateur administrateur	Seul un administrateur peut installer des apps.
Être propriétaire de l'atelier dans BolloPrint	Au moment de l'associer, seuls les ateliers dont vous êtes propriétaire apparaissent.
Que le TrueNAS et les imprimantes soient sur le même réseau	S'ils sont sur des réseaux séparés, l'agent fonctionne pareil, mais vous devrez ajouter les imprimantes par leur IP.
Que le TrueNAS ait accès à internet	C'est tout : aucun port à ouvrir ni IP fixe nécessaire.

---

1. Copiez le YAML depuis BolloPrint

Dans BolloPrint, allez dans Paramètres → Imprimantes → Agent local → Nouvel agent et choisissez TrueNAS.

Vous verrez les étapes et, en dessous, un encadré avec le YAML : le texte qui indique à TrueNAS quoi installer. Appuyez sur Copier.

Sur cet écran, il n'y a rien à créer : le YAML est le même pour tous les ateliers et ne contient aucune clé. L'agent naît au moment où vous l'associez, à l'étape 3.

Si vous voulez savoir ce qu'il fait, le YAML a cette forme (copiez toujours celui de BolloPrint, qui porte la bonne version dans la ligne image:) :

services:
  bolloprint-agent:
    image: ghcr.io/bolloprint/bolloprint-agent:XXXX
    restart: unless-stopped
    network_mode: host
    mem_limit: 512m
    pids_limit: 512
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    environment:
      BP_PLATFORM: truenas
      BP_LINK_LISTEN: ":8257"
    volumes:
      - data:/var/lib/bolloprint

volumes:
  data:

x-portals:
  - name: Web UI
    scheme: http
    host: 0.0.0.0
    port: 8257
    path: /

• network_mode: host place l'agent sur le réseau de votre TrueNAS : c'est comme ça qu'il trouve les imprimantes.
• BP_LINK_LISTEN ouvre sa page sur le port 8257, et x-portals est ce qui ajoute le bouton Web UI dans TrueNAS.
• data est le dossier où l'agent garde son identité et son association. Il survit aux redémarrages et aux mises à jour.

---

2. Installez-le sur TrueNAS

1. Connectez-vous à TrueNAS et ouvrez Apps.
2. Appuyez sur Discover Apps.
3. En haut à droite, à côté de Custom App, ouvrez le menu ⋮ et choisissez Install via YAML.
4. Dans Name, saisissez bolloprint-agent.
5. Dans Custom Config, collez le YAML que vous avez copié.
6. Appuyez sur Save.

TrueNAS télécharge l'agent et le démarre. En une minute, il apparaît dans Apps → Installed comme Running.

---

3. Associez-le à votre atelier

1. Dans Apps → Installed, appuyez sur bolloprint-agent. À droite, dans Application Info, appuyez sur Web UI. La page de l'agent s'ouvre dans un nouvel onglet.
2. La page indique « Cet agent n'appartient encore à aucun atelier » et affiche un code de huit caractères, comme 6E7B-9DEF. Appuyez sur Associer à BolloPrint.
3. BolloPrint s'ouvre. Si vous n'êtes pas connecté, connectez-vous. Choisissez l'atelier auquel vous l'ajoutez.
4. BolloPrint vous montre l'Appareil (le nom de votre TrueNAS et « TrueNAS ») et le Code. Vérifiez que c'est le même que celui affiché sur la page de l'agent, donnez un nom à l'agent et appuyez sur Ajouter à l'atelier.
5. Vous revenez dans BolloPrint, sur la liste des agents. La page de l'agent indique maintenant Associé à votre atelier.

C'est fait. Dans Paramètres → Imprimantes → Agent local, vous verrez l'agent avec le logo de TrueNAS, En ligne.

---

4. Donnez-lui les imprimantes

L'agent commence à chercher des imprimantes sur votre réseau dès qu'il est associé. Ce qu'il trouve apparaît dans Imprimantes sur le réseau local, sous la liste des agents, et c'est de là que vous les enregistrez. Celles qui n'apparaissent pas toutes seules, avec Ajouter par IP.

Comment faire pour chaque marque, c'est dans Imprimantes en réseau local.

---

Le mettre à jour

Vous n'avez rien à faire. 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. Il la garde dans son dossier de données, donc il reste sur cette version même si vous redémarrez l'app ou le TrueNAS.

C'est pourquoi, dans TrueNAS, l'app continue d'indiquer Up to date et la ligne image: de son YAML ne change pas : c'est la version avec laquelle il a été installé, pas celle qui tourne. Celle qui tourne, vous la voyez dans BolloPrint, à côté de l'agent.

Seulement si BolloPrint vous avertit que cet agent a besoin d'une mise à jour manuelle :

1. Dans Apps → Installed, appuyez sur bolloprint-agent puis sur Edit.
2. Dans Custom Config, changez uniquement la version à la fin de la ligne image: par celle qu'affiche BolloPrint dans Nouvel agent → TrueNAS. Ne touchez à rien d'autre.
3. Appuyez sur Save.

L'agent reste associé au même atelier, avec les mêmes imprimantes et leur historique. Il n'y a rien à associer de nouveau.

---

Le déplacer sur un autre poste ou le réinstaller

Un agent installé de zéro, sur un autre poste ou sur le même après l'avoir supprimé, est un nouvel agent :

1. Installez-le et associez-le comme aux étapes 1 à 3.
2. Ajoutez vos imprimantes au nouvel agent : elles passent sur lui avec leur historique.
3. Supprimez l'ancien agent dans BolloPrint (Paramètres → Imprimantes → Agent local, menu ⋮ de l'agent → Supprimer).

---

Le retirer

1. Dans BolloPrint, supprimez l'agent : Paramètres → Imprimantes → Agent local, menu ⋮ de l'agent → Supprimer. En quelques secondes, l'agent s'en rend compte et sa page propose à nouveau Associer à BolloPrint.
2. Dans TrueNAS, Apps → Installed → bolloprint-agent → Delete.

Si vous le supprimez seulement dans TrueNAS, il continuera d'apparaître Hors ligne dans BolloPrint jusqu'à ce que vous le supprimiez là aussi.

---

Si quelque chose ne va pas

Ce que vous voyez	Que faire
Vous ne trouvez pas Install via YAML	Votre TrueNAS est antérieur à la 24.10, ou les apps ne sont pas activées (dans Apps, choisissez le pool demandé).
L'app ne dépasse pas Deploying ou reste en Stopped	Le TrueNAS n'arrive pas à atteindre internet pour télécharger l'agent. Vérifiez le réseau du TrueNAS et redémarrez l'app depuis Apps → Installed.
Web UI ouvre une page qui ne charge pas	Une autre app utilise déjà le port 8257. Dans Edit, remplacez ":8257" par ":8364" et le port: 8257 plus bas par port: 8364, les deux, puis appuyez sur Save.
Le code de BolloPrint ne correspond pas à celui de la page	Ne confirmez pas. Revenez sur la page de l'agent et appuyez à nouveau sur Associer à BolloPrint.
L'agent apparaît Hors ligne dans BolloPrint	Vérifiez dans TrueNAS que l'app est Running et que le TrueNAS a accès à internet. Son journal se trouve dans Apps → Installed → bolloprint-agent → Workloads, sous l'icône des journaux.
Il est associé mais ne trouve aucune imprimante	Le TrueNAS et les imprimantes doivent être sur le même réseau. Si ce n'est pas le cas, ajoutez-les avec Ajouter par IP.