🚀 Desplegar el agente
Cómo poner en marcha un agente local por primera vez: dónde instalarlo, cómo crearlo en BolloPrint y cómo arrancarlo en tu equipo. Si ya lo tienes funcionando y BolloPrint te avisa de que hay una versión nueva, lo que buscas es Actualizar el agente.
Dónde ponerlo
En cualquier equipo del taller que esté siempre encendido y en la misma red que las impresoras:
- un NAS (Synology, QNAP…),
- un mini-PC o un PC del taller,
- una Raspberry Pi,
- un servidor que ya tengas.
Necesita Docker (o Portainer, que es Docker con pantalla). Consume muy poco: entre 10 y 20 MB de memoria.
💡 Lo ideal es que esté en la MISMA red que las impresoras
Si el agente está en una red y las impresoras en otra (VLANs separadas, red de invitados, wifi aparte), no es que deje de funcionar: lo que se pierde es el descubrimiento automático, porque ese aviso de «estoy aquí» no cruza de una red a otra.
Las impresoras se añaden entonces a mano, por su IP, y funcionan igual — con todas sus prestaciones, sea la marca que sea. Lo único imprescindible es que las dos redes puedan hablarse (que el router o el cortafuegos deje pasar el tráfico entre ellas).
En Docker Desktop (Windows y Mac) no hay descubrimiento automático. Esos sistemas no dejan que el contenedor vea la red del equipo, así que las impresoras hay que añadirlas a mano, por IP. Igual que en el caso de las redes separadas: funcionan exactamente igual, solo hay un paso más al darlas de alta.
Crearlo en BolloPrint
- Ve a Configuración → Impresoras y abre la pestaña Agente local.
- Pulsa Nuevo agente y ponle un nombre que reconozcas. Mejor dónde está que qué es: «Planta baja», «Nave 2».
- Pulsa Crear agente.
- En el segundo paso aparece la plantilla de despliegue, con el código del agente y su identidad ya escritos dentro. Elige Docker Compose o Kubernetes y pulsa Copiar. No hay nada que sustituir.
🔐 Las claves se muestran una sola vez
Copia la plantilla en ese momento. Las claves no caducan, pero no las volveremos a enseñar. Si la pierdes, abre el agente con Editar y, en Despliegue, usa Regenerar claves.
Copia siempre el bloque desde la pantalla, no de un correo antiguo ni de un apunte: ahí va la versión del agente que toca en cada momento.
Arrancarlo en tu equipo
Elige la forma que uses. En las tres, la plantilla va tal cual, sin tocar nada.
Docker Compose
- Crea una carpeta para el agente, por ejemplo
bolloprint-agent. - Dentro, guarda la plantilla como
docker-compose.yml. - Desde esa carpeta, arráncalo:
docker compose up -d
Portainer
- Ve a Stacks → Add stack y ponle un nombre, por ejemplo
bolloprint-agent. - En Web editor, pega la plantilla de Docker Compose tal cual.
- Pulsa Deploy the stack.
Kubernetes
- Guarda la plantilla de Kubernetes en un fichero, por ejemplo
bolloprint-agent.yaml. - Aplícalo:
kubectl apply -f bolloprint-agent.yaml
Vuelve después a BolloPrint y pulsa Guardar en la ventana del agente.
Comprobar que funciona
En menos de un minuto, el agente aparece En línea en la pestaña Agente local. No te pedirá autorización: esa instalación ya viene autorizada.
Si no aparece, mira su registro en el equipo donde corre:
docker logs bolloprint_agent --tail 50
| Lo que pasa | Qué mirar |
|---|---|
| No aparece nunca | ¿Se pegó la plantilla entera, sin cambios? ¿El equipo llega a internet? ¿Hay un cortafuegos bloqueando la salida? |
| Aparece, pero pide autorización | La plantilla no lleva BP_AGENT_INSTANCE_ID (se editó a mano o es de antes). Regenera las claves y despliega la plantilla nueva tal cual. |
| Está en línea pero no encuentra impresoras | Si está en otra red que las impresoras o usas Docker Desktop, es lo esperado: añádelas con Añadir por IP. |
No hay que abrir puertos en el router, ni pedir IP fija, ni tocar el cortafuegos: el agente llama a BolloPrint, no al revés.
Con el agente en línea, el siguiente paso es conectar tus impresoras: lo tienes en Impresoras por red local.