🏠 Agente en Home Assistant

Si ya tienes un Home Assistant encendido día y noche en el taller, ya tienes dónde poner el agente: está siempre en marcha, está en tu red y tiene su propia tienda de apps. Esta página cuenta cómo instalarlo ahí, vincularlo con tu taller y mantenerlo al día.

Si tu equipo es otro (un NAS, un PC, un servidor con Docker), elige el tuyo en El agente local, donde también está lo que hace el agente, sea cual sea el equipo.

---

Lo que necesitas

• Home Assistant OS, que es la instalación que trae tienda de apps. Las instalaciones «Supervised» también la tienen, pero Home Assistant ya no las mantiene. Si tu Home Assistant va en Docker («Container»), no tiene apps: instala el agente con Docker, como cuenta Agente en Docker.
• Un equipo de 64 bits: un mini-PC o un PC con Intel o AMD, una Raspberry Pi 4 o 5, o un Home Assistant Green o Yellow. En una Raspberry Pi 3 o en un sistema de 32 bits la app no se puede instalar.
• Que Home Assistant esté en la misma red que tus impresoras. Si va en una máquina virtual, su red tiene que estar en modo puente (bridge), no en NAT.
• El puerto 8257 libre en ese equipo. Si lo usa otra cosa, se cambia en un momento (más abajo).
• Ser propietario del taller en BolloPrint: el agente solo se puede vincular a un taller tuyo.

---

Instalarlo

1. Desde un ordenador o un móvil conectado a tu red, abre este enlace: Añadir BolloPrint a mi Home Assistant. Es una página de Home Assistant: la primera vez te pide la dirección de tu Home Assistant, por ejemplo http://homeassistant.local:8123.
2. Pulsa Open link. Tu Home Assistant te pregunta si quieres añadir el repositorio de aplicaciones de BolloPrint: pulsa Añadir.
3. Se abre la ficha de BolloPrint Agent, con el perro de BolloPrint. Pulsa Instalar. Home Assistant prepara la app él mismo; tarda uno o dos minutos.
4. Pulsa Iniciar. Deja activado Iniciar en el arranque, para que el agente vuelva solo cada vez que se reinicie Home Assistant.

---

Vincularlo con tu taller

1. En la ficha de la app, pulsa Open Web UI (Home Assistant lo deja en inglés). Se abre la página del agente en una pestaña nueva: dice que todavía no pertenece a ningún taller y enseña un código, como 8054-627E.
2. Pulsa Vincular con BolloPrint. Te lleva a BolloPrint; entra con tu cuenta si te lo pide.
3. Elige el taller, comprueba que el código es el mismo que el de la página del agente, revisa el nombre que te propone (el de tu Home Assistant; puedes cambiarlo) y confirma.
4. Vuelves a la página del agente, que ya dice «Vinculado a …». En menos de un minuto lo verás En línea en Configuración → Impresoras → Agente local, con el logo de Home Assistant, y empezará a buscar tus impresoras.

En BolloPrint no hay que crear nada antes. La tarjeta Home Assistant de Nuevo agente solo te recuerda estos pasos.

---

El puerto de la página

La página del agente usa el puerto 8257 del equipo de Home Assistant. Si otra cosa ya lo está usando, la app se para nada más arrancar y su pestaña Registro dice address already in use. Para cambiarlo:

1. En la ficha de la app, abre la pestaña Configuración.
2. En Red, pon otro número (por ejemplo 8364) y pulsa Guardar.
3. Home Assistant te pregunta si reinicia la app: acepta. Open Web UI ya te lleva al puerto nuevo.

Cambiar el puerto no desvincula el agente: sigue siendo el mismo, con sus impresoras.

---

Mantenerlo al día

Aquí se actualizan dos cosas, y casi nunca tienes que hacer nada:

Qué	Cómo se actualiza
El agente, lo que habla con tus impresoras	Solo. Cuando BolloPrint publica una versión nueva, la descarga y la instala él mismo.
La app de Home Assistant, lo que pone en marcha el agente	Cuando Home Assistant te avise de una actualización de BolloPrint Agent, pulsa Actualizar en su ficha. Si activas Actualización automática en la ficha, lo hará él solo.

Actualizar la app no desvincula el agente. Su identidad se guarda en los datos de la app, que también entran en las copias de seguridad de Home Assistant.

---

Cambiarlo de equipo o reinstalarlo

• Si reinstalas la app o la pones en otro Home Assistant, vincúlala otra vez: será un agente nuevo. Añade tus impresoras con él (las encontrará solo si están en su red, o por IP) y pasarán con su número y todo su historial. Después elimina el agente antiguo, que se habrá quedado sin impresoras.
• Si restauras en el mismo Home Assistant una copia de seguridad que incluya la app, el agente vuelve tal cual, ya vinculado.

---

Desinstalarlo

1. En BolloPrint, ve a Configuración → Impresoras → Agente local, abre el menú ⋮ del agente y pulsa Eliminar. Las impresoras que solo llegaban por él desaparecen de la lista; si un día las vuelves a añadir, regresan con su historial.
2. En unos segundos, la página del agente vuelve a ofrecer Vincular con BolloPrint. Si ya no lo quieres, en la ficha de la app de Home Assistant abre el menú ⋮ y pulsa Desinstalar.
3. Si quieres, quita también el repositorio: Tienda de aplicaciones → ⋮ → Repositorios, y la papelera junto a BolloPrint.

Si desinstalas la app sin eliminar antes el agente, en BolloPrint se queda como Desconectado. Elimínalo desde su menú ⋮.

---

Cuando algo no va

Lo primero es la pestaña Registro de la app en Home Assistant: cuenta lo que hace el agente y, si se para, por qué.

Síntoma	Qué hacer
BolloPrint Agent no aparece en la tienda	En Tienda de aplicaciones, menú ⋮ → Buscar actualizaciones, y recarga la página. Si en Configuración no tienes Aplicaciones, tu Home Assistant no tiene apps: instala el agente con Docker.
No te deja instalarla	Tu equipo es de 32 bits, como una Raspberry Pi 3. La app necesita 64 bits.
La instalación falla a medias	Home Assistant descarga el agente al instalarlo: comprueba que tiene internet y vuelve a intentarlo.
La app se para nada más iniciarla	Mira el Registro. Si dice address already in use, el puerto está ocupado: cámbialo como se explica arriba.
Open Web UI no carga	Estás fuera de la red del taller (acceso remoto, VPN, datos del móvil). Ábrelo desde la red local.
Al vincular no aparece tu taller	Solo puedes vincular el agente a talleres de los que eres propietario. Pide al propietario que lo vincule él.
No encuentra ninguna impresora	¿Está Home Assistant en la misma red que ellas? En una máquina virtual, su red tiene que estar en modo puente. Si están en redes separadas, añádelas por IP: funcionan igual.
Lo eliminaste en BolloPrint y la página sigue diciendo «Vinculado»	Espera un minuto y recarga: el agente se reinicia solo, sin vincular.