AllMyPrinters

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.

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.

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

  1. 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 user door je gebruikersnaam op het apparaat en de cijfers door het IP-adres ervan (dat zie je in de apparatenlijst van je router):

    ssh [email protected]

    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.

  2. Controleren of Docker geïnstalleerd is

    Plak dit en druk op Enter:

    docker --version

    Zie je iets als Docker version 27.3.1? Ga dan door naar stap 3. Zie je command not found? Installeer Docker dan met deze regel, dat duurt een paar minuten:

    curl -fsSL https://get.docker.com | sudo sh

    Voer op een Raspberry Pi ook uname -m uit. Daar moet aarch64 uitkomen. Staat er armv7l, dan draait de Pi een 32-bit systeem: installeer eerst Raspberry Pi OS (64-bit).

  3. De agent starten

    Plak deze regel. Je wachtwoord van hierboven staat er al in. Vraagt sudo om 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:latest

    Bij 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.

  4. Controleren of hij draait en het adres opzoeken

    Plak dit:

    sudo docker ps --filter name=allmyprinters-agent

    Onder STATUS hoort Up te staan en na ongeveer een minuut (healthy). Vraag nu het adres van het apparaat op:

    hostname -I

    Het 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:latest
De agent verwijderen

Stopt en verwijdert de agent. Je gegevens blijven bewaard, dus je kunt hem altijd weer starten:

sudo docker rm -f allmyprinters-agent

Wil je ook al zijn gegevens wissen (printers, spoelen, geschiedenis, bibliotheek)? Dat kun je niet ongedaan maken:

sudo docker volume rm allmyprinters-agent

Synology NAS (DSM 7.2 of nieuwer)

  1. 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.

  2. 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.

  3. 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-agent

    Klik 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.

  4. Controleren of hij draait

    Onder Container hoort allmyprinters-agent nu te draaien. Het adres is hetzelfde waarmee je DSM opent, alleen zonder :5000, bijvoorbeeld 192.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-agent

Unraid

  1. Controleren of Docker aan staat

    Settings → Docker: „Enable Docker” moet op Yes staan. Standaard staat het al aan.

  2. De terminal openen

    Klik rechtsboven in de webinterface van Unraid op het terminalicoon >_.

  3. 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:latest

    Bij de eerste start wordt de agent gedownload. Aan het eind zie je een lange regel letters en cijfers. Dan is het gelukt.

  4. Controleren of hij draait

    Op het tabblad Docker staat allmyprinters-agent nu als gestart. Unraid noemt hem een container zonder template, dat is prima. Het adres is dat van je Unraid-server, bijvoorbeeld 192.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:latest
De agent verwijderen

Stopt en verwijdert de agent. Je gegevens blijven bewaard:

docker rm -f allmyprinters-agent

Wil je ook al zijn gegevens wissen? Dat kun je niet ongedaan maken:

docker volume rm allmyprinters-agent

Portainer

  1. Een stack toevoegen

    Log in bij Portainer, kies je omgeving (meestal local) en klik op Stacks → Add stack.

  2. 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-agent
  3. Starten

    Scrol naar beneden en klik op Deploy the stack. Portainer downloadt de agent en start hem, dat kan een minuut duren.

  4. Controleren of hij draait

    Onder Containers hoort bij allmyprinters-agent running te staan en na ongeveer een minuut healthy. Het adres is het IP van het apparaat waarop Portainer draait, bijvoorbeeld 192.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.

  1. 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.

  2. Het adres van deze computer opzoeken

    Windows: open PowerShell (Startmenu, typ „PowerShell”) en voer ipconfig uit. Neem het IPv4-adres van je netwerkadapter (Ethernet of Wi-Fi), bijvoorbeeld 192.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:

  3. 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:latest

    Bij 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.

  4. Controleren of hij draait

    In Docker Desktop hoort allmyprinters-agent onder Containers nu te draaien. Op deze computer open je de agent op http://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:latest
De agent verwijderen

Stopt en verwijdert de agent. Je gegevens blijven bewaard:

docker rm -f allmyprinters-agent

Wil je ook al zijn gegevens wissen? Dat kun je niet ongedaan maken:

docker volume rm allmyprinters-agent

Home 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.

  1. Repository toevoegen

    Klik op de knop. Je Home Assistant opent en vraagt of de AllMyPrinters-repository toegevoegd moet worden. Bevestig met Toevoegen.

    Toevoegen aan Home Assistant

    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-allmyprinters
  2. App installeren

    Laad de winkel opnieuw en open AllMyPrinters Agent. Klik op Installeren, dan Starten, en zet Weergeven in zijbalk aan.

  3. 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.

  4. 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

  1. De agent openen

    Open op een computer, tablet of telefoon in je thuisnetwerk http://<address>:8090 in de browser, bijvoorbeeld http://192.168.1.50:8090. Log in met je wachtwoord en sla de pagina op als bladwijzer.

  2. 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.

  3. 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.

  4. 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.

  5. 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.