💾 Agent op TrueNAS

Heb je een TrueNAS in de werkplaats, dan heb je al een plek voor de lokale agent: hij staat de hele dag aan en zit in hetzelfde netwerk als je printers. De agent draait als een gewone app van TrueNAS, naast de apps die je al hebt.

Deze pagina legt uit hoe je hem installeert, aan je werkplaats koppelt, bijwerkt, verhuist en verwijdert. Wat de agent is en welke printers hij verbindt, lees je in De lokale agent.

---

Voordat je begint

Wat je nodig hebt	Hoe je het controleert
TrueNAS 24.10 of nieuwer (Community Edition)	In TrueNAS: Dashboard → System Information → Version. Oudere versies hebben geen Install via YAML.
De apps van TrueNAS ingeschakeld	In Apps staat bovenaan Apps Service Running. Is het de eerste keer, dan vraagt TrueNAS je de pool te kiezen waarin ze worden opgeslagen.
Inloggen op TrueNAS als beheerder	Alleen een beheerder kan apps installeren.
Eigenaar zijn van de werkplaats in BolloPrint	Bij het koppelen zie je alleen de werkplaatsen waarvan je eigenaar bent.
TrueNAS en printers in hetzelfde netwerk	Zitten ze in gescheiden netwerken, dan werkt de agent net zo goed, maar moet je de printers via hun IP toevoegen.
TrueNAS met toegang tot internet	Meer niet: je hoeft geen poorten open te zetten en geen vast IP te hebben.

---

1. Kopieer de YAML uit BolloPrint

Ga in BolloPrint naar Instellingen → Printers → Lokale agent → Nieuwe agent en kies TrueNAS.

Je ziet de stappen en daaronder een vak met de YAML: de tekst die TrueNAS vertelt wat het moet installeren. Klik op Kopiëren.

Op dat scherm hoef je niets aan te maken: de YAML is voor alle werkplaatsen hetzelfde en bevat geen sleutels. De agent ontstaat pas als je hem koppelt, in stap 3.

Wil je weten wat hij doet: de YAML ziet er zo uit (kopieer altijd die uit BolloPrint, want daarin staat de juiste versie op de regel 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 zet de agent in het netwerk van je TrueNAS: zo vindt hij de printers.
• BP_LINK_LISTEN opent zijn pagina op poort 8257, en x-portals zorgt voor de knop Web UI in TrueNAS.
• data is de map waarin de agent zijn identiteit en zijn koppeling bewaart. Die blijft bewaard bij herstarts en updates.

---

2. Installeer hem in TrueNAS

1. Log in op TrueNAS en open Apps.
2. Klik op Discover Apps.
3. Open rechtsboven, naast Custom App, het menu ⋮ en kies Install via YAML.
4. Vul bij Name bolloprint-agent in.
5. Plak bij Custom Config de YAML die je hebt gekopieerd.
6. Klik op Save.

TrueNAS downloadt de agent en start hem. Binnen een minuut staat hij in Apps → Installed als Running.

---

3. Koppel hem aan je werkplaats

1. Klik in Apps → Installed op bolloprint-agent. Klik rechts, onder Application Info, op Web UI. De pagina van de agent opent in een nieuw tabblad.
2. Op de pagina staat “Deze agent hoort nog bij geen enkele werkplaats” en een code van acht tekens, zoals 6E7B-9DEF. Klik op Koppelen met BolloPrint.
3. BolloPrint gaat open. Ben je niet ingelogd, log dan in. Kies de werkplaats waaraan je hem toevoegt.
4. BolloPrint toont je het apparaat (de naam van je TrueNAS en “TrueNAS”) en de code. Controleer of die dezelfde is als op de pagina van de agent, geef de agent een naam en klik op Toevoegen aan werkplaats.
5. Je komt terug in BolloPrint, bij de lijst met agents. Op de pagina van de agent staat nu Gekoppeld aan met de naam van je werkplaats.

Klaar. In Instellingen → Printers → Lokale agent zie je de agent met het TrueNAS-logo, Online.

---

4. Geef hem de printers

De agent begint printers in je netwerk te zoeken zodra hij gekoppeld is. Wat hij vindt verschijnt onder Printers op het lokale netwerk, onder de lijst met agents, en daar voeg je ze toe. Printers die niet vanzelf verschijnen, voeg je toe met Toevoegen via IP.

Hoe je dat per merk doet, lees je in Printers via het lokale netwerk.

---

Bijwerken

Je hoeft niets te doen. De agent werkt zichzelf bij: als er een nieuwe versie uitkomt, downloadt hij die, controleert hij of die van ons is en herstart hij ermee. Hij bewaart die versie in zijn datamap, dus hij blijft erop, ook als je de app of de TrueNAS herstart.

Daarom blijft de app in TrueNAS Up to date zeggen en verandert de regel image: in zijn YAML niet: dat is de versie waarmee hij is geïnstalleerd, niet de versie die draait. Welke versie draait, zie je in BolloPrint, naast de agent.

Alleen als BolloPrint je laat weten dat die agent een handmatige update nodig heeft:

1. Klik in Apps → Installed op bolloprint-agent en daarna op Edit.
2. Verander in Custom Config alleen de versie aan het eind van de regel image: in de versie die BolloPrint toont bij Nieuwe agent → TrueNAS. Verander verder niets.
3. Klik op Save.

De agent blijft gekoppeld aan dezelfde werkplaats, met dezelfde printers en hun geschiedenis. Je hoeft niets opnieuw te koppelen.

---

Naar een ander apparaat verhuizen of opnieuw installeren

Een agent die je vanaf nul installeert, op een ander apparaat of op hetzelfde nadat je hem hebt verwijderd, is een nieuwe agent:

1. Installeer en koppel hem zoals in stap 1 tot en met 3.
2. Voeg je printers toe aan de nieuwe agent: ze gaan met hun geschiedenis naar hem over.
3. Verwijder de oude agent in BolloPrint (Instellingen → Printers → Lokale agent, menu ⋮ van de agent → Verwijderen).

---

Verwijderen

1. Verwijder de agent in BolloPrint: Instellingen → Printers → Lokale agent, menu ⋮ van de agent → Verwijderen. Binnen een paar seconden merkt de agent dat, en zijn pagina biedt weer Koppelen met BolloPrint aan.
2. In TrueNAS: Apps → Installed → bolloprint-agent → Delete.

Verwijder je hem alleen in TrueNAS, dan blijft hij in BolloPrint op Offline staan tot je hem daar ook verwijdert.

---

Als iets niet werkt

Wat je ziet	Wat je doet
Je vindt Install via YAML niet	Je TrueNAS is ouder dan 24.10, of de apps zijn niet ingeschakeld (kies in Apps de pool waar om gevraagd wordt).
De app komt niet verder dan Deploying of blijft op Stopped staan	TrueNAS kan het internet niet bereiken om de agent te downloaden. Controleer het netwerk van de TrueNAS en start de app opnieuw vanuit Apps → Installed.
Web UI opent een pagina die niet laadt	Een andere app gebruikt poort 8257 al. Verander in Edit ":8257" in ":8364" en de port: 8257 daaronder in port: 8364, allebei, en klik op Save.
De code in BolloPrint komt niet overeen met die op de pagina	Bevestig niet. Ga terug naar de pagina van de agent en klik opnieuw op Koppelen met BolloPrint.
De agent staat in BolloPrint op Offline	Controleer in TrueNAS of de app op Running staat en of de TrueNAS het internet kan bereiken. Het log vind je in Apps → Installed → bolloprint-agent → Workloads, onder het log-icoon.
Hij is gekoppeld maar vindt geen printers	De TrueNAS en de printers moeten in hetzelfde netwerk zitten. Is dat niet zo, voeg ze dan toe met Toevoegen via IP.