💾 Agente en TrueNAS

Si tienes un TrueNAS en el taller, ya tienes dónde poner el agente local: está encendido todo el día y en la misma red que tus impresoras. El agente corre como una app más de TrueNAS, junto a las que ya tengas.

Esta página explica cómo instalarlo, vincularlo con tu taller, actualizarlo, moverlo y quitarlo. Qué es el agente y qué impresoras conecta lo tienes en El agente local.

---

Antes de empezar

Qué necesitas	Cómo lo compruebas
TrueNAS 24.10 o posterior (Community Edition)	En TrueNAS, Dashboard → System Information → Version. Las versiones anteriores no tienen Install via YAML.
Las apps de TrueNAS activadas	En Apps, arriba sale Apps Service Running. Si es la primera vez, TrueNAS te pide elegir el pool donde guardarlas.
Entrar en TrueNAS con un usuario administrador	Solo un administrador puede instalar apps.
Ser dueño del taller en BolloPrint	Al vincularlo solo salen los talleres de los que eres dueño.
Que el TrueNAS y las impresoras estén en la misma red	Si están en redes separadas el agente funciona igual, pero tendrás que añadir las impresoras por su IP.
Que el TrueNAS salga a internet	Nada más: no hay que abrir puertos ni tener IP fija.

---

1. Copia el YAML de BolloPrint

En BolloPrint, ve a Configuración → Impresoras → Agente local → Nuevo agente y elige TrueNAS.

Verás los pasos y, debajo, un recuadro con el YAML: el texto que le dice a TrueNAS qué instalar. Pulsa Copiar.

En esa pantalla no hay que crear nada: el YAML es el mismo para todos los talleres y no lleva claves. El agente nace cuando lo vinculas, en el paso 3.

Por si te interesa saber qué hace, el YAML tiene esta forma (copia siempre el de BolloPrint, que lleva la versión que toca en la línea 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 deja al agente en la red de tu TrueNAS: así encuentra las impresoras.
• BP_LINK_LISTEN abre su página en el puerto 8257, y x-portals es lo que pone el botón Web UI en TrueNAS.
• data es la carpeta donde el agente guarda su identidad y su vínculo. Sobrevive a reinicios y actualizaciones.

---

2. Instálalo en TrueNAS

1. Entra en TrueNAS y abre Apps.
2. Pulsa Discover Apps.
3. Arriba a la derecha, junto a Custom App, abre el menú ⋮ y elige Install via YAML.
4. En Name, escribe bolloprint-agent.
5. En Custom Config, pega el YAML que copiaste.
6. Pulsa Save.

TrueNAS descarga el agente y lo arranca. En un minuto aparece en Apps → Installed como Running.

---

3. Vincúlalo con tu taller

1. En Apps → Installed, pulsa bolloprint-agent. A la derecha, en Application Info, pulsa Web UI. Se abre la página del agente en una pestaña nueva.
2. La página dice «Este agente todavía no pertenece a ningún taller» y enseña un código de ocho caracteres, como 6E7B-9DEF. Pulsa Vincular con BolloPrint.
3. Se abre BolloPrint. Si no tienes la sesión iniciada, inicia sesión. Elige el taller al que lo añades.
4. BolloPrint te enseña el equipo (el nombre de tu TrueNAS y «TrueNAS») y el código. Comprueba que es el mismo que salía en la página del agente, ponle un nombre al agente y pulsa Añadir al taller.
5. Vuelves a BolloPrint, a la lista de agentes. La página del agente ahora dice Vinculado a tu taller.

Ya está. En Configuración → Impresoras → Agente local verás el agente con el logo de TrueNAS, En línea.

---

4. Dale las impresoras

El agente empieza a buscar impresoras en tu red en cuanto se vincula. Lo que encuentra aparece en Impresoras por red local, debajo de la lista de agentes, y desde ahí las das de alta. Las que no aparezcan solas, con Añadir por IP.

Cómo hacerlo con cada marca está en Impresoras por red local.

---

Actualizarlo

No tienes que hacer nada. El agente se actualiza solo: cuando sale una versión nueva, la descarga, comprueba que es nuestra y se reinicia con ella. La guarda en su carpeta de datos, así que sigue en esa versión aunque reinicies la app o el TrueNAS.

Por eso en TrueNAS la app sigue diciendo Up to date y la línea image: de su YAML no cambia: es la versión con la que se instaló, no la que está corriendo. La que corre la ves en BolloPrint, junto al agente.

Solo si BolloPrint te avisa de que ese agente necesita una actualización manual:

1. En Apps → Installed, pulsa bolloprint-agent y luego Edit.
2. En Custom Config, cambia solo la versión del final de la línea image: por la que enseña BolloPrint en Nuevo agente → TrueNAS. No toques nada más.
3. Pulsa Save.

El agente sigue vinculado al mismo taller, con las mismas impresoras y su historial. No hay que vincular nada otra vez.

---

Moverlo a otro equipo o reinstalarlo

Un agente que se instala de cero, en otro equipo o en el mismo después de borrarlo, es un agente nuevo:

1. Instálalo y vincúlalo como en los pasos 1 a 3.
2. Añade tus impresoras al agente nuevo: pasan a él con su historial.
3. Elimina el agente antiguo en BolloPrint (Configuración → Impresoras → Agente local, menú ⋮ del agente → Eliminar).

---

Quitarlo

1. En BolloPrint, elimina el agente: Configuración → Impresoras → Agente local, menú ⋮ del agente → Eliminar. En unos segundos el agente se entera y su página vuelve a ofrecer Vincular con BolloPrint.
2. En TrueNAS, Apps → Installed → bolloprint-agent → Delete.

Si solo lo borras en TrueNAS, en BolloPrint seguirá saliendo como Desconectado hasta que lo elimines también ahí.

---

Si algo no va

Lo que ves	Qué hacer
No encuentras Install via YAML	Tu TrueNAS es anterior a la 24.10, o las apps no están activadas (en Apps, elige el pool que te pide).
La app no pasa de Deploying o se queda en Stopped	El TrueNAS no llega a internet para descargar el agente. Comprueba la red del TrueNAS y vuelve a arrancar la app desde Apps → Installed.
Web UI abre una página que no carga	Otra app ya usa el puerto 8257. En Edit, cambia ":8257" por ":8364" y el port: 8257 de abajo por port: 8364, los dos, y pulsa Save.
El código de BolloPrint no coincide con el de la página	No confirmes. Vuelve a la página del agente y pulsa otra vez Vincular con BolloPrint.
El agente sale Desconectado en BolloPrint	Comprueba en TrueNAS que la app está Running y que el TrueNAS sale a internet. Su registro está en Apps → Installed → bolloprint-agent → Workloads, en el icono de registros.
Está vinculado pero no encuentra impresoras	El TrueNAS y las impresoras tienen que estar en la misma red. Si no lo están, añádelas con Añadir por IP.