🏠 Agent in Home Assistant

Wenn du schon einen Home Assistant hast, der Tag und Nacht in der Werkstatt läuft, hast du schon einen Platz für den Agenten: Er ist immer an, er ist in deinem Netzwerk und er hat seinen eigenen App-Store. Auf dieser Seite steht, wie du ihn dort installierst, mit deiner Werkstatt verknüpfst und auf dem neuesten Stand hältst.

Wenn dein Rechner etwas anderes ist (ein NAS, ein PC, ein Server mit Docker), such dir deinen unter Der lokale Agent aus. Dort steht auch, was der Agent macht, egal auf welchem Rechner.

---

Was du brauchst

• Home Assistant OS, die Installation, die einen App-Store mitbringt. Die „Supervised“-Installationen haben ihn auch, aber Home Assistant pflegt sie nicht mehr. Wenn dein Home Assistant in Docker läuft („Container“), hat er keine Apps: Installiere den Agenten mit Docker, wie unter Agent in Docker beschrieben.
• Ein 64-Bit-Gerät: ein Mini-PC oder ein PC mit Intel oder AMD, ein Raspberry Pi 4 oder 5 oder ein Home Assistant Green oder Yellow. Auf einem Raspberry Pi 3 oder einem 32-Bit-System lässt sich die App nicht installieren.
• Dass Home Assistant im selben Netzwerk wie deine Drucker ist. Wenn er in einer virtuellen Maschine läuft, muss deren Netzwerk im Modus Brücke (Bridge) sein, nicht NAT.
• Port 8257 frei auf diesem Rechner. Wenn ihn etwas anderes belegt, ist er im Handumdrehen geändert (weiter unten).
• Du musst Inhaber der Werkstatt in BolloPrint sein: Der Agent lässt sich nur mit einer Werkstatt verknüpfen, die dir gehört.

---

Installieren

1. Öffne von einem Computer oder Handy in deinem Netzwerk diesen Link: BolloPrint zu meinem Home Assistant hinzufügen. Das ist eine Seite von Home Assistant: Beim ersten Mal fragt sie nach der Adresse deines Home Assistant, zum Beispiel http://homeassistant.local:8123.
2. Klick auf Open link. Dein Home Assistant fragt, ob du das App-Repository von BolloPrint hinzufügen willst: Klick auf Hinzufügen.
3. Die Seite von BolloPrint Agent öffnet sich, mit dem BolloPrint-Hund. Klick auf Installieren. Home Assistant bereitet die App selbst vor; das dauert ein, zwei Minuten.
4. Klick auf Starten. Lass Beim Systemstart starten aktiviert, damit der Agent bei jedem Neustart von Home Assistant von selbst wieder hochkommt.

---

Mit deiner Werkstatt verknüpfen

1. Klick auf der Seite der App auf Benutzeroberfläche öffnen. Die Seite des Agenten öffnet sich in einem neuen Tab: Dort steht, dass er noch zu keiner Werkstatt gehört, und sie zeigt einen Code wie 8054-627E.
2. Klick auf Mit BolloPrint verknüpfen. Du landest in BolloPrint; melde dich mit deinem Konto an, wenn danach gefragt wird.
3. Wähl die Werkstatt, prüf, dass der Code derselbe ist wie auf der Seite des Agenten, schau dir den vorgeschlagenen Namen an (den deines Home Assistant; du kannst ihn ändern) und bestätige.
4. Du kommst zurück auf die Seite des Agenten, auf der jetzt „Verknüpft mit …“ steht. In weniger als einer Minute siehst du ihn als Online unter Einstellungen → Drucker → Lokaler Agent, mit dem Logo von Home Assistant, und er beginnt, deine Drucker zu suchen.

In BolloPrint musst du vorher nichts anlegen. Die Karte Home Assistant unter Neuer Agent erinnert dich nur an diese Schritte.

---

Der Port der Seite

Die Seite des Agenten nutzt Port 8257 auf dem Home-Assistant-Gerät. Wenn ihn schon etwas anderes belegt, stoppt die App gleich nach dem Start, und ihr Tab Protokoll zeigt address already in use. So änderst du ihn:

1. Öffne auf der Seite der App den Tab Konfiguration.
2. Trag unter Netzwerk eine andere Nummer ein (zum Beispiel 8364) und klick auf Speichern.
3. Home Assistant fragt, ob die App neu gestartet werden soll: Bestätige. Benutzeroberfläche öffnen bringt dich jetzt zum neuen Port.

Den Port zu ändern hebt die Verknüpfung des Agenten nicht auf: Er bleibt derselbe, mit seinen Druckern.

---

Auf dem neuesten Stand halten

Hier werden zwei Dinge aktualisiert, und du musst fast nie etwas tun:

Was	Wie es aktualisiert wird
Der Agent, der Teil, der mit deinen Druckern spricht	Von selbst. Wenn BolloPrint eine neue Version veröffentlicht, lädt er sie herunter und installiert sie selbst.
Die App von Home Assistant, der Teil, der den Agenten startet	Wenn Home Assistant dir ein Update für BolloPrint Agent meldet, klick auf seiner Seite auf Aktualisieren. Wenn du auf der Seite Automatische Updates einschaltest, macht er das von selbst.

Die App zu aktualisieren hebt die Verknüpfung des Agenten nicht auf. Seine Identität wird in den Daten der App gespeichert, die auch in den Backups von Home Assistant enthalten sind.

---

Auf ein anderes Gerät umziehen oder neu installieren

• Wenn du die App neu installierst oder auf einen anderen Home Assistant bringst, verknüpfe sie erneut: Sie wird ein neuer Agent. Füg deine Drucker mit ihm hinzu (er findet sie von selbst, wenn sie in seinem Netzwerk sind, oder per IP), und sie kommen mit ihrer Nummer und ihrem ganzen Verlauf mit. Lösch danach den alten Agenten, der dann keine Drucker mehr hat.
• Wenn du auf demselben Home Assistant ein Backup wiederherstellst, das die App enthält, kommt der Agent genau so zurück, schon verknüpft.

---

Deinstallieren

1. Geh in BolloPrint zu Einstellungen → Drucker → Lokaler Agent, öffne das Menü ⋮ des Agenten und klick auf Löschen. Die Drucker, die nur über ihn erreichbar waren, verschwinden aus der Liste; wenn du sie irgendwann wieder hinzufügst, kommen sie mit ihrem Verlauf zurück.
2. Nach ein paar Sekunden bietet die Seite des Agenten wieder Mit BolloPrint verknüpfen an. Wenn du ihn nicht mehr willst, öffne auf der Seite der App in Home Assistant das Menü ⋮ und klick auf Deinstallieren.
3. Wenn du magst, entferne auch das Repository: App-Store → ⋮ → Repositories, und der Papierkorb neben BolloPrint.

Wenn du die App deinstallierst, ohne vorher den Agenten zu löschen, bleibt er in BolloPrint als Offline stehen. Lösch ihn über sein Menü ⋮.

---

Wenn etwas nicht klappt

Als Erstes schaust du in den Tab Protokoll der App in Home Assistant: Dort steht, was der Agent tut und, wenn er stoppt, warum.

Symptom	Was tun
BolloPrint Agent erscheint nicht im Store	Im App-Store Menü ⋮ → Nach Updates suchen, und lade die Seite neu. Wenn es unter Einstellungen keine Apps gibt, hat dein Home Assistant keine Apps: Installiere den Agenten mit Docker.
Du kannst sie nicht installieren	Dein Gerät ist 32-Bit, wie ein Raspberry Pi 3. Die App braucht 64 Bit.
Die Installation bricht mittendrin ab	Home Assistant lädt den Agenten bei der Installation herunter: Prüf, ob er Internet hat, und versuch es noch einmal.
Die App stoppt gleich nach dem Start	Schau ins Protokoll. Steht dort address already in use, ist der Port belegt: Ändere ihn wie oben beschrieben.
Benutzeroberfläche öffnen zeigt nichts an	Du bist außerhalb des Werkstattnetzwerks (Fernzugriff, VPN, mobile Daten). Öffne es aus dem lokalen Netzwerk.
Beim Verknüpfen erscheint deine Werkstatt nicht	Du kannst den Agenten nur mit Werkstätten verknüpfen, deren Inhaber du bist. Bitte den Inhaber, ihn selbst zu verknüpfen.
Er findet keinen Drucker	Ist Home Assistant im selben Netzwerk wie sie? In einer virtuellen Maschine muss deren Netzwerk im Modus Brücke sein. Wenn sie in getrennten Netzwerken sind, füg sie per IP hinzu: Sie funktionieren genauso.
Du hast ihn in BolloPrint gelöscht, und auf der Seite steht immer noch „Verknüpft“	Warte eine Minute und lade neu: Der Agent startet von selbst neu, ohne Verknüpfung.