🏠 Agent in Home Assistant

Heb je al een Home Assistant die dag en nacht aan staat in de werkplaats, dan heb je ook al een plek voor de agent: hij draait altijd, zit in je netwerk en heeft zijn eigen app-store. Op deze pagina lees je hoe je hem daar installeert, koppelt aan je werkplaats en up-to-date houdt.

Heb je een ander apparaat (een NAS, een pc, een server met Docker), kies dan het jouwe in De lokale agent. Daar staat ook wat de agent doet, op welk apparaat dan ook.

---

Wat je nodig hebt

• Home Assistant OS, de installatie waar een app-store bij zit. “Supervised”-installaties hebben die ook, maar Home Assistant onderhoudt ze niet meer. Draait je Home Assistant in Docker (“Container”), dan heeft hij geen apps: installeer de agent dan met Docker, zoals Agent in Docker uitlegt.
• Een 64-bits apparaat: een mini-pc of een pc met Intel of AMD, een Raspberry Pi 4 of 5, of een Home Assistant Green of Yellow. Op een Raspberry Pi 3 of een 32-bits systeem kun je de app niet installeren.
• Home Assistant moet in hetzelfde netwerk zitten als je printers. Draait hij in een virtuele machine, dan moet het netwerk daarvan in bridge-modus staan, niet in NAT.
• Poort 8257 moet vrij zijn op dat apparaat. Gebruikt iets anders hem al, dan pas je dat zo aan (zie verderop).
• Je moet eigenaar van de werkplaats zijn in BolloPrint: de agent kan alleen worden gekoppeld aan een werkplaats van jou.

---

Hem installeren

1. Open vanaf een computer of telefoon die op je netwerk zit deze link: BolloPrint toevoegen aan mijn Home Assistant. Het is een pagina van Home Assistant: de eerste keer vraagt hij het adres van je Home Assistant, bijvoorbeeld http://homeassistant.local:8123.
2. Klik op Open link. Je Home Assistant vraagt of je de app-repository van BolloPrint wilt toevoegen: klik op Toevoegen.
3. De pagina van BolloPrint Agent gaat open, met de hond van BolloPrint. Klik op Installeren. Home Assistant zet de app zelf klaar; dat duurt een à twee minuten.
4. Klik op Starten. Laat Bij systeemstart starten aan staan, zodat de agent vanzelf terugkomt elke keer dat Home Assistant opnieuw opstart.

---

Hem koppelen aan je werkplaats

1. Klik op de pagina van de app op Web UI openen. De pagina van de agent opent in een nieuw tabblad: daar staat dat hij nog bij geen enkele werkplaats hoort, en je ziet een code, zoals 8054-627E.
2. Klik op Koppelen met BolloPrint. Je komt in BolloPrint terecht; log in met je account als daarom wordt gevraagd.
3. Kies de werkplaats, controleer of de code dezelfde is als op de pagina van de agent, kijk de voorgestelde naam na (die van je Home Assistant; je kunt hem aanpassen) en bevestig.
4. Je gaat terug naar de pagina van de agent, waar nu “Gekoppeld aan …” staat. Binnen een minuut zie je hem op Online staan in Instellingen → Printers → Lokale agent, met het logo van Home Assistant, en begint hij je printers te zoeken.

In BolloPrint hoef je vooraf niets aan te maken. De kaart Home Assistant bij Nieuwe agent herinnert je alleen aan deze stappen.

---

De poort van de pagina

De pagina van de agent gebruikt poort 8257 van het apparaat waarop Home Assistant draait. Gebruikt iets anders die al, dan stopt de app meteen na het starten en staat er in het tabblad Logboek address already in use. Zo verander je hem:

1. Open op de pagina van de app het tabblad Configuratie.
2. Vul bij Netwerk een ander nummer in (bijvoorbeeld 8364) en klik op Opslaan.
3. Home Assistant vraagt of hij de app opnieuw moet starten: zeg ja. Web UI openen brengt je nu naar de nieuwe poort.

Een andere poort ontkoppelt de agent niet: hij blijft dezelfde, met zijn printers.

---

Hem up-to-date houden

Hier worden twee dingen bijgewerkt, en je hoeft er bijna nooit iets voor te doen:

Wat	Hoe het wordt bijgewerkt
De agent, het deel dat met je printers praat	Vanzelf. Als BolloPrint een nieuwe versie uitbrengt, downloadt en installeert hij die zelf.
De app van Home Assistant, het deel dat de agent laat draaien	Meldt Home Assistant een update van BolloPrint Agent, klik dan op Bijwerken op de pagina van de app. Zet je daar Automatisch bijwerken aan, dan doet hij het zelf.

De app bijwerken ontkoppelt de agent niet. Zijn identiteit wordt bewaard in de gegevens van de app, die ook in de back-ups van Home Assistant terechtkomen.

---

Naar een ander apparaat of opnieuw installeren

• Installeer je de app opnieuw of zet je hem op een andere Home Assistant, koppel hem dan opnieuw: het wordt een nieuwe agent. Voeg daarmee je printers toe (hij vindt ze zelf als ze in zijn netwerk zitten, of via IP) en ze gaan mee met hun nummer en hun hele geschiedenis. Daarna verwijder je de oude agent, die dan geen printers meer heeft.
• Zet je op dezelfde Home Assistant een back-up terug waar de app in zit, dan komt de agent precies zo terug, al gekoppeld.

---

Hem verwijderen

1. Ga in BolloPrint naar Instellingen → Printers → Lokale agent, open het menu ⋮ van de agent en klik op Verwijderen. De printers die alleen via hem binnenkwamen verdwijnen uit de lijst; voeg je ze ooit weer toe, dan komen ze terug met hun geschiedenis.
2. Binnen een paar seconden biedt de pagina van de agent weer Koppelen met BolloPrint aan. Wil je hem niet meer, open dan op de pagina van de app in Home Assistant het menu ⋮ en klik op Verwijderen.
3. Wil je, haal dan ook de repository weg: App-store → ⋮ → Repositories, en het prullenbakje naast BolloPrint.

Verwijder je de app zonder eerst de agent te verwijderen, dan blijft hij in BolloPrint staan als Offline. Verwijder hem via zijn menu ⋮.

---

Als er iets misgaat

Kijk eerst in het tabblad Logboek van de app in Home Assistant: daar staat wat de agent doet en, als hij stopt, waarom.

Symptoom	Wat je doet
BolloPrint Agent verschijnt niet in de winkel	Kies in App-store het menu ⋮ → Op updates controleren en laad de pagina opnieuw. Staat er bij Instellingen geen Apps, dan heeft je Home Assistant geen apps: installeer de agent met Docker.
Je kunt hem niet installeren	Je apparaat is 32-bits, zoals een Raspberry Pi 3. De app heeft 64 bits nodig.
De installatie mislukt halverwege	Home Assistant downloadt de agent tijdens het installeren: controleer of hij internet heeft en probeer het opnieuw.
De app stopt meteen na het starten	Kijk in het Logboek. Staat er address already in use, dan is de poort bezet: verander hem zoals hierboven uitgelegd.
Web UI openen laadt niet	Je zit buiten het netwerk van de werkplaats (externe toegang, VPN, mobiele data). Open hem vanaf het lokale netwerk.
Bij het koppelen staat je werkplaats er niet bij	Je kunt de agent alleen koppelen aan werkplaatsen waarvan je eigenaar bent. Vraag de eigenaar om hem zelf te koppelen.
Hij vindt geen enkele printer	Zit Home Assistant in hetzelfde netwerk als de printers? In een virtuele machine moet het netwerk in bridge-modus staan. Zitten ze in gescheiden netwerken, voeg ze dan toe via IP: ze werken precies hetzelfde.
Je hebt hem in BolloPrint verwijderd en op de pagina staat nog steeds “Gekoppeld”	Wacht een minuut en laad opnieuw: de agent herstart vanzelf, zonder koppeling.