Voor NAS en Raspberry Pi
De agent installeren, stap voor stap
Kies je systeem, kopieer elke regel met één klik en plak hem. Je hoeft Docker niet te kennen. Het duurt ongeveer 10 minuten.
Een apparaat dat altijd aan staat
Een mini-pc zoals een Intel NUC, een NAS (Synology, QNAP, Unraid), een Raspberry Pi 4 of 5 met een 64-bit systeem of een Linux-pc. Een Windows-pc of Mac kan ook, maar moet dan aan blijven.
In hetzelfde netwerk als je printers
Via kabel of wifi, aan dezelfde router.
Ongeveer 10 minuten
Elk commando heeft een kopieerknop. Je hoeft niets met de hand te typen.
Jouw instellingen
Kies een wachtwoord voor de webpagina van de agent. We zetten het in elk commando hieronder, zodat je alleen hoeft te kopiëren en plakken. Het blijft in dit browsertabblad en wordt nergens heen gestuurd.
Minstens 6 tekens: letters, cijfers, - _ . (geen spaties), zodat de commando’s overal werken. Laat 8090 staan, tenzij een ander programma die poort al gebruikt.
Gebruik alleen letters, cijfers en - _ . en minstens 6 tekens. Tot die tijd staat in de commando’s „JouwWachtwoord”.
Kies je systeem
Twijfel je? Een mini-pc (zoals een NUC) of een Raspberry Pi met Ubuntu, Debian of Raspberry Pi OS valt onder „Linux”. Beheer je je containers al in Portainer, kies dan Portainer.
Linux: mini-pc, NUC, Raspberry Pi, thuisserver
Een terminal openen op het apparaat
Zit je aan het apparaat zelf, open dan de app Terminal. Vanaf een andere computer: open PowerShell (Windows) of Terminal (Mac) en maak verbinding via SSH. Vervang
userdoor je gebruikersnaam op het apparaat en de cijfers door het IP-adres ervan (dat zie je in de apparatenlijst van je router):Bij de eerste verbinding typ je
yes. Terwijl je het wachtwoord typt, verschijnt er niets op het scherm. Dat is normaal, druk gewoon op Enter.Controleren of Docker geïnstalleerd is
Plak dit en druk op Enter:
docker --versionZie je iets als
Docker version 27.3.1? Ga dan door naar stap 3. Zie jecommand not found? Installeer Docker dan met deze regel, dat duurt een paar minuten:curl -fsSL https://get.docker.com | sudo shVoer op een Raspberry Pi ook
uname -muit. Daar moetaarch64uitkomen. Staat erarmv7l, dan draait de Pi een 32-bit systeem: installeer eerst Raspberry Pi OS (64-bit).De agent starten
Plak deze regel. Je wachtwoord van hierboven staat er al in. Vraagt
sudoom een wachtwoord, dan is dat het wachtwoord van je gebruiker op het apparaat:sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBij de eerste start wordt de agent gedownload, dat kan een minuut of twee duren. Aan het eind zie je een lange regel letters en cijfers. Dan is het gelukt.
Controleren of hij draait en het adres opzoeken
Plak dit:
sudo docker ps --filter name=allmyprinters-agentOnder STATUS hoort
Upte staan en na ongeveer een minuut(healthy). Vraag nu het adres van het apparaat op:hostname -IHet eerste getal, bijvoorbeeld
192.168.1.50, is het adres. Ga hieronder verder bij „De agent openen”.
Later bijwerken
Voer deze regel uit. Hij downloadt de nieuwste versie en start de agent opnieuw met dezelfde instellingen. Je gegevens blijven bewaard.
sudo docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && sudo docker rm -f allmyprinters-agent && sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDe agent verwijderen
Stopt en verwijdert de agent. Je gegevens blijven bewaard, dus je kunt hem altijd weer starten:
sudo docker rm -f allmyprinters-agentWil je ook al zijn gegevens wissen (printers, spoelen, geschiedenis, bibliotheek)? Dat kun je niet ongedaan maken:
sudo docker volume rm allmyprinters-agentSynology NAS (DSM 7.2 of nieuwer)
Container Manager installeren
Open in DSM het Package Center, zoek naar Container Manager en installeer het. Is je DSM ouder dan 7.2, werk het dan eerst bij: vóór 7.2 heette het pakket Docker en kon het nog geen projecten maken.
Een map maken
Open File Station. Maak in de gedeelde map docker (die heeft Container Manager aangemaakt) een nieuwe map met de naam
allmyprinters-agent.Het project maken
Open Container Manager → Project → Maken en vul in:
- Projectnaam:
allmyprinters-agent - Pad: klik op Pad instellen en kies docker → allmyprinters-agent
- Bron: docker-compose.yml maken
Plak dit in het tekstvak. Je wachtwoord staat er al in:
services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "JouwWachtwoord" AMP_PORT: "8090" AMP_LANG: "nl" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentKlik op Volgende. Laat het webportaal (Web Station) uit staan, klik nog een keer op Volgende en daarna op Gereed. Container Manager downloadt de agent en start hem, dat kan een minuut of twee duren.
- Projectnaam:
Controleren of hij draait
Onder Container hoort
allmyprinters-agentnu te draaien. Het adres is hetzelfde waarmee je DSM opent, alleen zonder:5000, bijvoorbeeld192.168.1.50. Ga hieronder verder bij „De agent openen”.
Later bijwerken
Container Manager kijkt ongeveer één keer per dag of er nieuwe versies zijn. Staat bij Image naast de agent „Update beschikbaar”, selecteer hem dan en kies Bijwerken. Container Manager start de agent opnieuw met de nieuwe versie, je gegevens blijven bewaard.
De agent verwijderen
Project → allmyprinters-agent → Actie → Stoppen, daarna Verwijderen. De gegevens van de agent blijven op de NAS staan. Wil je die ook wissen, voer dan dit uit via SSH (kun je niet ongedaan maken):
sudo docker volume rm allmyprinters-agentUnraid
Controleren of Docker aan staat
Settings → Docker: „Enable Docker” moet op Yes staan. Standaard staat het al aan.
De terminal openen
Klik rechtsboven in de webinterface van Unraid op het terminalicoon >_.
De agent starten
Plak deze regel en druk op Enter. Je wachtwoord staat er al in:
docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBij de eerste start wordt de agent gedownload. Aan het eind zie je een lange regel letters en cijfers. Dan is het gelukt.
Controleren of hij draait
Op het tabblad Docker staat
allmyprinters-agentnu als gestart. Unraid noemt hem een container zonder template, dat is prima. Het adres is dat van je Unraid-server, bijvoorbeeld192.168.1.50. Ga hieronder verder bij „De agent openen”.
Later bijwerken
De eigen updateknop van Unraid werkt niet voor containers die op deze manier gestart zijn. Open in plaats daarvan de terminal en voer deze regel uit. Je gegevens blijven bewaard:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && docker rm -f allmyprinters-agent && docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDe agent verwijderen
Stopt en verwijdert de agent. Je gegevens blijven bewaard:
docker rm -f allmyprinters-agentWil je ook al zijn gegevens wissen? Dat kun je niet ongedaan maken:
docker volume rm allmyprinters-agentPortainer
Een stack toevoegen
Log in bij Portainer, kies je omgeving (meestal local) en klik op Stacks → Add stack.
De agent plakken
Name:
allmyprinters-agent. Build method: Web editor. Plak dit in de editor. Je wachtwoord staat er al in:services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "JouwWachtwoord" AMP_PORT: "8090" AMP_LANG: "nl" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentStarten
Scrol naar beneden en klik op Deploy the stack. Portainer downloadt de agent en start hem, dat kan een minuut duren.
Controleren of hij draait
Onder Containers hoort bij
allmyprinters-agentrunning te staan en na ongeveer een minuut healthy. Het adres is het IP van het apparaat waarop Portainer draait, bijvoorbeeld192.168.1.50. Ga hieronder verder bij „De agent openen”.
Later bijwerken
Stacks → allmyprinters-agent → Editor → Update the stack. Zet in het venster Re-pull image and redeploy aan en bevestig. Je gegevens blijven bewaard.
De agent verwijderen
Stacks → vink allmyprinters-agent aan → Remove. De gegevens van de agent blijven in het volume allmyprinters-agent. Wil je die ook wissen, verwijder dan dat volume onder Volumes (kun je niet ongedaan maken).
Windows-pc of Mac met Docker Desktop
Docker Desktop kan de agent geen directe toegang tot je netwerk geven. De agent werkt wel, maar zijn zoekfunctie vindt geen printers van Bambu Lab en Elegoo: voeg die toe met hun IP-adres. De computer moet aan blijven en mag niet in slaapstand gaan, anders stopt de agent ook.
Docker Desktop installeren
Al geïnstalleerd, bijvoorbeeld voor een andere container? Sla deze stap dan over. Anders download je Docker Desktop van docker.com, installeer je het en start je het.
Open daarna in Docker Desktop Settings → General en zet „Start Docker Desktop when you sign in to your computer” aan, zodat de agent na een herstart vanzelf terugkomt.
Het adres van deze computer opzoeken
Windows: open PowerShell (Startmenu, typ „PowerShell”) en voer
ipconfiguit. Neem het IPv4-adres van je netwerkadapter (Ethernet of Wi-Fi), bijvoorbeeld192.168.1.50.Mac: Systeeminstellingen → Netwerk → bij je verbinding staat het IP-adres.
Vul het hier in, het commando in stap 3 past zich vanzelf aan:
Dat lijkt geen adres in je thuisnetwerk (bijv. 192.168.1.50).
De agent starten
Plak deze regel in PowerShell (Windows) of Terminal (Mac) en druk op Enter. Je wachtwoord en het adres staan er al in:
docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestBij de eerste start wordt de agent gedownload, dat kan een minuut of twee duren. Vraagt Windows of Docker het netwerk mag gebruiken, sta het dan toe voor privénetwerken.
Controleren of hij draait
In Docker Desktop hoort
allmyprinters-agentonder Containers nu te draaien. Op deze computer open je de agent ophttp://localhost:8090. Ga hieronder verder bij „De agent openen”.
Later bijwerken
Voer deze regel uit in PowerShell of Terminal. Hij downloadt de nieuwste versie en start de agent opnieuw. Je gegevens blijven bewaard:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest; docker rm -f allmyprinters-agent; docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=JouwWachtwoord -e AMP_PORT=8090 -e AMP_LANG=nl -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDe agent verwijderen
Stopt en verwijdert de agent. Je gegevens blijven bewaard:
docker rm -f allmyprinters-agentWil je ook al zijn gegevens wissen? Dat kun je niet ongedaan maken:
docker volume rm allmyprinters-agentHome Assistant OS (app)
Hiervoor heb je Home Assistant OS of een Supervised-installatie nodig. Draait je Home Assistant zelf in Docker, volg dan op die machine de Linux-stappen. Het wachtwoordveld bovenaan heb je hier niet nodig: Home Assistant regelt het inloggen.
Repository toevoegen
Klik op de knop. Je Home Assistant opent en vraagt of de AllMyPrinters-repository toegevoegd moet worden. Bevestig met Toevoegen.
Daarvoor moet je in deze browser bij Home Assistant ingelogd zijn. Anders open je in Home Assistant de app-winkel, ⋮ rechtsboven → Repositories, en voeg je dit adres toe:
https://github.com/nolimitek/ha-allmyprintersApp installeren
Laad de winkel opnieuw en open AllMyPrinters Agent. Klik op Installeren, dan Starten, en zet Weergeven in zijbalk aan.
Openen
Klik op AllMyPrinters in de zijbalk. Dat is de agent, met printers, spoelen en instellingen zoals in de app. „Open de agent” hieronder kun je overslaan.
Optioneel: entiteiten en dashboards
Voor printers, spoelen, camera en pauzeren/annuleren als entiteiten installeer je in HACS de integratie AllMyPrinters (aangepaste repository, hetzelfde adres als hierboven, type Integratie) en herstart je Home Assistant. Ze verschijnt dan onder Instellingen → Apparaten en diensten → Ontdekt, je hoeft alleen te bevestigen.
Later bijwerken
Home Assistant biedt updates aan onder Instellingen → Updates, net als bij elke andere app. Je gegevens blijven en zitten in je Home Assistant-back-ups.
De agent verwijderen
Instellingen → Apps → AllMyPrinters Agent → Verwijderen. Daarmee worden ook de gegevens van de agent in Home Assistant gewist. Wil je ze bewaren, sla dan eerst een bestand op in de agent onder Instellingen → Back-up.
Daarna, op elk systeem
De agent openen
Open op een computer, tablet of telefoon in je thuisnetwerk
http://<address>:8090in de browser, bijvoorbeeldhttp://192.168.1.50:8090. Log in met je wachtwoord en sla de pagina op als bladwijzer.De app verbinden
In de agent: Meer → Instellingen → Apparaten koppelen → Apparaat toevoegen. Er verschijnt een QR-code die 10 minuten geldig is.
In de app: Meer → Instellingen → Met agent verbinden → QR-code scannen.
De app vraagt dan welke gegevens je wilt houden. Staan je printers en spoelen al in de app, kies dan Gegevens van de app gebruiken: alles verhuist naar de agent. Je hebt app-versie 0.8.1 of nieuwer nodig.
Meer printers toevoegen
Printers die nog niet in de app staan, voeg je in de agent toe, net als in de app: de zoekfunctie doorzoekt je netwerk en de handleiding per merk vertelt wat je op de printer moet aanzetten.
Optioneel: overal toegang
In de agent: Meer → Instellingen → Overal toegang → Aanzetten. Dan bereiken je gekoppelde apparaten de agent ook onderweg, en op een pc of iPhone open je hem op allmyprinters.com/web. Het blijft uit tot je het zelf aanzet, en alles is end-to-end versleuteld.
Optioneel: Home Assistant
Printers, spoelen, filamentboxen en camera in Home Assistant: installeer in HACS de integratie AllMyPrinters (aangepaste repository
https://github.com/nolimitek/ha-allmyprinters, type Integratie). Voeg hem daarna toe onder Instellingen → Apparaten en diensten met het adres van de agent en de sleutel uit Meer → Instellingen → Home Assistant in de agent.
Werkt er iets niet?
„permission denied”
Zet sudo voor het commando. In onze Linux-commando’s staat het er al.
„The container name … is already in use”
De agent is al geïnstalleerd. Wil je hem met nieuwe instellingen starten (bijvoorbeeld een nieuw wachtwoord), verwijder dan eerst de oude container met sudo docker rm -f allmyprinters-agent (op Windows, Mac en Unraid zonder sudo). Je gegevens blijven bewaard. Voer daarna het startcommando opnieuw uit.
„port is already allocated”, of het log meldt dat de poort bezet is
Een ander programma gebruikt poort 8090 al. Vul bovenaan een ander nummer in, bijvoorbeeld 8091, verwijder de container (zie hierboven) en start hem opnieuw met het nieuwe commando. Open de agent daarna met de nieuwe poort.
„no matching manifest” of „exec format error”
Het apparaat draait een 32-bit systeem en de agent heeft 64-bit nodig. Installeer op een Raspberry Pi 3, 4 of 5 Raspberry Pi OS (64-bit).
De pagina gaat niet open
Controleer of de agent draait (laatste stap voor jouw systeem) en of je het juiste adres en de juiste poort gebruikt. Het log zegt vaak waarom: sudo docker logs --tail 30 allmyprinters-agent. Een firewall kan de poort blokkeren: voer op Ubuntu met ufw sudo ufw allow 8090/tcp uit. Op Synology sta je de poort toe onder Configuratiescherm → Beveiliging → Firewall.
Ik ben het wachtwoord vergeten
Vul bovenaan een nieuw wachtwoord in, verwijder de container (je gegevens blijven bewaard) en start hem opnieuw met het nieuwe commando. Bij Synology of Portainer pas je het wachtwoord aan in de compose-tekst en werk je het project of de stack bij.
De zoekfunctie vindt mijn printer niet
Voeg hem toe met zijn IP-adres. Dat vind je op het scherm van de printer of in je router. Op Windows en Mac is dat bij Bambu Lab en Elegoo altijd nodig.
Home Assistant OS, Proxmox, TrueNAS, OpenMediaVault, CasaOS?
Home Assistant OS: kies hierboven het tabblad Home Assistant, daar draait de agent als app. Proxmox: maak een kleine Debian- of Ubuntu-VM met Docker en volg daarin de Linux-stappen. TrueNAS SCALE, OpenMediaVault en CasaOS: open een shell via SSH en volg de Linux-stappen, of gebruik Portainer als je dat hebt.
Kom je er nog steeds niet uit?
Tik in de app op „Probleem melden” en beschrijf wat er gebeurt. De laatste regels van het log helpen enorm: sudo docker logs --tail 30 allmyprinters-agent.