AllMyPrinters

Per NAS e Raspberry Pi

Installa l’agente, passo dopo passo

Scegli il tuo sistema, copia ogni riga con un clic e incollala. Non serve conoscere Docker. Ci vogliono circa 10 minuti.

Le tue impostazioni

Scegli una password per la pagina web dell’agente. La inseriamo in tutti i comandi qui sotto, così devi solo copiare e incollare. Resta in questa scheda del browser e non viene inviata da nessuna parte.

Almeno 6 caratteri: lettere, numeri, - _ . (senza spazi), così i comandi funzionano ovunque. Lascia 8090, a meno che un altro programma non la usi già.

Scegli il tuo sistema

Nel dubbio: un mini PC (come un NUC) o un Raspberry Pi con Ubuntu, Debian o Raspberry Pi OS vale come «Linux». Se gestisci già i tuoi container con Portainer, scegli Portainer.

Linux: mini PC, NUC, Raspberry Pi, server di casa

  1. Apri un terminale sul dispositivo

    Se sei davanti al dispositivo, apri l’app Terminale. Da un altro computer, apri PowerShell (Windows) o Terminale (Mac) e collegati via SSH. Sostituisci user con il tuo nome utente sul dispositivo e i numeri con il suo indirizzo IP (lo vedi nell’elenco dei dispositivi del router):

    Al primo collegamento scrivi yes. Mentre digiti la password sullo schermo non compare nulla. È normale, premi semplicemente Invio.

  2. Controlla che Docker sia installato

    Incolla questa riga e premi Invio:

    docker --version

    Vedi qualcosa come Docker version 27.3.1? Allora vai al punto 3. Vedi command not found? Allora installa Docker con questa riga, ci vuole qualche minuto:

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

    Su un Raspberry Pi esegui anche uname -m. Deve comparire aarch64. Se compare armv7l, il Pi ha un sistema a 32 bit: prima installa Raspberry Pi OS (64-bit).

  3. Avvia l’agente

    Incolla questa riga. Contiene già la password che hai scelto sopra. Se sudo ti chiede una password, è quella del tuo utente sul dispositivo:

    sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest

    Al primo avvio viene scaricato l’agente, può volerci un minuto o due. Alla fine vedi una lunga riga di lettere e numeri: vuol dire che ha funzionato.

  4. Controlla che funzioni e trova l’indirizzo

    Incolla questa riga:

    sudo docker ps --filter name=allmyprinters-agent

    Sotto STATUS deve comparire Up e, dopo circa un minuto, (healthy). Ora trova l’indirizzo del dispositivo:

    hostname -I

    Il primo numero, per esempio 192.168.1.50, è l’indirizzo. Continua più sotto con «Apri l’agente».

Aggiornare in seguito

Esegui questa riga. Scarica la versione più recente e riavvia l’agente con le stesse impostazioni. I tuoi dati restano.

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=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest
Rimuovere l’agente

Ferma e rimuove l’agente. I tuoi dati restano, quindi puoi riavviarlo quando vuoi:

sudo docker rm -f allmyprinters-agent

Per cancellare anche tutti i suoi dati (stampanti, bobine, cronologia, libreria). Non si può annullare:

sudo docker volume rm allmyprinters-agent

NAS Synology (DSM 7.2 o successivo)

  1. Installa Container Manager

    In DSM apri il Centro pacchetti, cerca Container Manager e installalo. Se il tuo DSM è più vecchio della 7.2, aggiornalo prima: prima della 7.2 il pacchetto si chiamava Docker e non sapeva creare progetti.

  2. Crea una cartella

    Apri File Station. Nella cartella condivisa docker (l’ha creata Container Manager) crea una nuova cartella chiamata allmyprinters-agent.

  3. Crea il progetto

    Apri Container Manager → Progetto → Crea e compila così:

    • Nome progetto: allmyprinters-agent
    • Percorso: clicca Imposta percorso e scegli docker → allmyprinters-agent
    • Origine: Crea docker-compose.yml

    Incolla questo testo nella casella. Contiene già la tua password:

    services:
      allmyprinters-agent:
        image: ghcr.io/nolimitek/allmyprinters-agent:latest
        container_name: allmyprinters-agent
        restart: unless-stopped
        network_mode: host
        environment:
          AMP_PASSWORD: "LaTuaPassword"
          AMP_PORT: "8090"
          AMP_LANG: "it"
        volumes:
          - allmyprinters-agent:/data
    volumes:
      allmyprinters-agent:
        name: allmyprinters-agent

    Clicca Avanti. Lascia spento il portale web (Web Station), clicca di nuovo Avanti e poi Fine. Container Manager scarica l’agente e lo avvia, può volerci un minuto o due.

  4. Controlla che funzioni

    In Container, allmyprinters-agent deve risultare In esecuzione. L’indirizzo è quello che usi per aprire DSM, senza :5000, per esempio 192.168.1.50. Continua più sotto con «Apri l’agente».

Aggiornare in seguito

Container Manager cerca nuove versioni circa una volta al giorno. Quando in Immagine accanto all’agente compare «Aggiornamento disponibile», selezionalo e scegli Aggiorna. Container Manager riavvia l’agente con la nuova versione, i tuoi dati restano.

Rimuovere l’agente

Progetto → allmyprinters-agent → Azione → Arresta, poi Elimina. I dati dell’agente restano sul NAS. Per cancellare anche quelli, esegui questa riga via SSH (non si può annullare):

sudo docker volume rm allmyprinters-agent

Unraid

  1. Controlla che Docker sia attivo

    Settings → Docker: «Enable Docker» deve essere su Yes. Di solito è già attivo.

  2. Apri il terminale

    Clicca l’icona del terminale >_ in alto a destra nell’interfaccia web di Unraid.

  3. Avvia l’agente

    Incolla questa riga e premi Invio. Contiene già la tua password:

    docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest

    Al primo avvio viene scaricato l’agente. Alla fine vedi una lunga riga di lettere e numeri: vuol dire che ha funzionato.

  4. Controlla che funzioni

    Nella scheda Docker ora allmyprinters-agent risulta avviato. Unraid lo segna come container senza template, va bene così. L’indirizzo è quello del tuo server Unraid, per esempio 192.168.1.50. Continua più sotto con «Apri l’agente».

Aggiornare in seguito

Il pulsante di aggiornamento di Unraid non funziona con i container avviati in questo modo. Apri invece il terminale ed esegui questa riga. I tuoi dati restano:

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=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest
Rimuovere l’agente

Ferma e rimuove l’agente. I tuoi dati restano:

docker rm -f allmyprinters-agent

Per cancellare anche tutti i suoi dati. Non si può annullare:

docker volume rm allmyprinters-agent

Portainer

  1. Aggiungi uno stack

    Accedi a Portainer, scegli il tuo ambiente (di solito local) e clicca Stacks → Add stack.

  2. Incolla l’agente

    Come Name scrivi allmyprinters-agent, come Build method scegli Web editor. Incolla questo testo nell’editor. Contiene già la tua password:

    services:
      allmyprinters-agent:
        image: ghcr.io/nolimitek/allmyprinters-agent:latest
        container_name: allmyprinters-agent
        restart: unless-stopped
        network_mode: host
        environment:
          AMP_PASSWORD: "LaTuaPassword"
          AMP_PORT: "8090"
          AMP_LANG: "it"
        volumes:
          - allmyprinters-agent:/data
    volumes:
      allmyprinters-agent:
        name: allmyprinters-agent
  3. Avvialo

    Scorri in basso e clicca Deploy the stack. Portainer scarica l’agente e lo avvia, può volerci un minuto.

  4. Controlla che funzioni

    In Containers, allmyprinters-agent deve risultare running e, dopo circa un minuto, healthy. L’indirizzo è l’IP del dispositivo su cui gira Portainer, per esempio 192.168.1.50. Continua più sotto con «Apri l’agente».

Aggiornare in seguito

Stacks → allmyprinters-agent → Editor → Update the stack. Nella finestra che si apre attiva Re-pull image and redeploy e conferma. I tuoi dati restano.

Rimuovere l’agente

Stacks → spunta allmyprinters-agent → Remove. I dati dell’agente restano nel volume allmyprinters-agent. Per cancellare anche quelli, rimuovi il volume in Volumes (non si può annullare).

PC Windows o Mac con Docker Desktop

Docker Desktop non può dare all’agente accesso diretto alla tua rete. L’agente funziona, ma la ricerca non trova le stampanti Bambu Lab ed Elegoo: aggiungile con il loro indirizzo IP. Il computer deve restare acceso e non deve andare in sospensione, altrimenti si ferma anche l’agente.

  1. Installa Docker Desktop

    Ce l’hai già, per esempio per un altro container? Allora salta questo passaggio. Altrimenti scarica Docker Desktop da docker.com, installalo e avvialo.

    Poi in Docker Desktop apri Settings → General e attiva «Start Docker Desktop when you sign in to your computer», così l’agente riparte dopo un riavvio.

  2. Trova l’indirizzo di questo computer

    Windows: apri PowerShell (menu Start, scrivi «PowerShell») ed esegui ipconfig. Prendi la riga Indirizzo IPv4 della tua scheda di rete (Ethernet o Wi-Fi), per esempio 192.168.1.50.

    Mac: Impostazioni di Sistema → Rete → la tua connessione mostra l’indirizzo IP.

    Inseriscilo qui, il comando del punto 3 si aggiorna da solo:

  3. Avvia l’agente

    Incolla questa riga in PowerShell (Windows) o nel Terminale (Mac) e premi Invio. Contiene già la tua password e l’indirizzo:

    docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest

    Al primo avvio viene scaricato l’agente, può volerci un minuto o due. Se Windows chiede se Docker può usare la rete, consentilo per le reti private.

  4. Controlla che funzioni

    In Docker Desktop, sotto Containers, allmyprinters-agent deve risultare in esecuzione. Su questo computer apri l’agente all’indirizzo http://localhost:8090. Continua più sotto con «Apri l’agente».

Aggiornare in seguito

Esegui questa riga in PowerShell o nel Terminale. Scarica la versione più recente e riavvia l’agente. I tuoi dati restano:

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=LaTuaPassword -e AMP_PORT=8090 -e AMP_LANG=it -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latest
Rimuovere l’agente

Ferma e rimuove l’agente. I tuoi dati restano:

docker rm -f allmyprinters-agent

Per cancellare anche tutti i suoi dati. Non si può annullare:

docker volume rm allmyprinters-agent

Home Assistant OS (app)

Serve Home Assistant OS o un’installazione Supervised. Se il tuo Home Assistant gira in Docker, segui invece i passaggi per Linux su quella macchina. Il campo password in alto qui non serve: all’accesso pensa Home Assistant.

  1. Aggiungi il repository

    Clicca il pulsante. Si apre il tuo Home Assistant e chiede se aggiungere il repository di AllMyPrinters. Conferma con Aggiungi.

    Aggiungi a Home Assistant

    Per farlo devi aver effettuato l’accesso a Home Assistant in questo browser. Altrimenti apri lo store delle app in Home Assistant, ⋮ in alto a destra → Repository, e aggiungi questo indirizzo:

    https://github.com/nolimitek/ha-allmyprinters
  2. Installa l’app

    Ricarica lo store e apri AllMyPrinters Agent. Clicca Installa, poi Avvia, e attiva Mostra nella barra laterale.

  3. Aprila

    Clicca AllMyPrinters nella barra laterale. È l’agente, con stampanti, bobine e impostazioni come nell’app. Puoi saltare «Apri l’agente» più sotto.

  4. Facoltativo: entità e dashboard

    Per avere stampanti, bobine, fotocamera e pausa/annulla come entità, installa l’integrazione AllMyPrinters in HACS (repository personalizzato, stesso indirizzo di sopra, tipo Integrazione) e riavvia Home Assistant. Compare poi in Impostazioni → Dispositivi e servizi → Rilevati, basta confermarla.

Aggiornare in seguito

Home Assistant offre gli aggiornamenti in Impostazioni → Aggiornamenti, come per ogni altra app. I tuoi dati restano e fanno parte dei backup di Home Assistant.

Rimuovere l’agente

Impostazioni → App → AllMyPrinters Agent → Disinstalla. Così vengono cancellati anche i dati dell’agente in Home Assistant. Per tenerli, salva prima un file nell’agente in Impostazioni → Backup.

Poi, su qualsiasi sistema

  1. Apri l’agente

    Da qualsiasi computer, tablet o telefono della tua rete di casa, apri nel browser http://<address>:8090 con l’indirizzo del dispositivo, per esempio http://192.168.1.50:8090. Accedi con la tua password e salva la pagina nei preferiti.

  2. Collega l’app

    Nell’agente: Altro → Impostazioni → Associa dispositivi → Aggiungi dispositivo. Compare un codice QR, valido per 10 minuti.

    Nell’app: Altro → Impostazioni → Collega all’agente → Scansiona codice QR.

    L’app ti chiede poi quali dati tenere. Se stampanti e bobine sono già nell’app, scegli Usa i dati dell’app: tutto passa all’agente. Serve l’app 0.8.1 o successiva.

  3. Aggiungi altre stampanti

    Le stampanti che non sono ancora nell’app si aggiungono nell’agente, proprio come nell’app: la ricerca esplora la tua rete e la guida di ogni marca ti dice cosa attivare sulla stampante.

  4. Facoltativo: accesso ovunque

    Nell’agente: Altro → Impostazioni → Accesso ovunque → Attiva. Così i tuoi dispositivi associati raggiungono l’agente anche fuori casa, e su PC o iPhone lo apri da allmyprinters.com/web. Resta spento finché non lo attivi, e tutto è cifrato end-to-end.

  5. Facoltativo: Home Assistant

    Stampanti, bobine, box del filamento e fotocamera in Home Assistant: installa l’integrazione AllMyPrinters in HACS (repository personalizzato https://github.com/nolimitek/ha-allmyprinters, tipo Integrazione). Poi aggiungila in Impostazioni → Dispositivi e servizi con l’indirizzo dell’agente e la chiave da Altro → Impostazioni → Home Assistant nell’agente.

Qualcosa non funziona?

«permission denied»

Metti sudo davanti al comando. Nei nostri comandi per Linux c’è già.

«The container name … is already in use»

L’agente è già installato. Per avviarlo con nuove impostazioni (per esempio una nuova password), rimuovi prima il vecchio container con sudo docker rm -f allmyprinters-agent (su Windows, Mac e Unraid senza sudo). I tuoi dati restano. Poi esegui di nuovo il comando di avvio.

«port is already allocated», oppure il log dice che la porta è occupata

Un altro programma usa già la porta 8090. Inserisci un altro numero in alto, per esempio 8091, rimuovi il container (vedi sopra) e riavvialo con il nuovo comando. Poi apri l’agente con la nuova porta.

«no matching manifest» o «exec format error»

Il dispositivo ha un sistema a 32 bit, ma l’agente richiede 64 bit. Su un Raspberry Pi 3, 4 o 5 installa Raspberry Pi OS (64-bit).

La pagina non si apre

Controlla che l’agente sia in funzione (ultimo passaggio per il tuo sistema) e di usare l’indirizzo e la porta giusti. Spesso il log ti dice il perché: sudo docker logs --tail 30 allmyprinters-agent. Un firewall può bloccare la porta: su Ubuntu con ufw esegui sudo ufw allow 8090/tcp. Su Synology consenti la porta in Pannello di controllo → Sicurezza → Firewall.

Ho dimenticato la password

Inseriscine una nuova in alto, rimuovi il container (i tuoi dati restano) e riavvialo con il nuovo comando. Con Synology o Portainer cambia la password nel testo compose e aggiorna il progetto o lo stack.

La ricerca non trova la mia stampante

Aggiungila con il suo indirizzo IP. Lo trovi sullo schermo della stampante o nel router. Su Windows e Mac per Bambu Lab ed Elegoo è sempre necessario.

Home Assistant OS, Proxmox, TrueNAS, OpenMediaVault, CasaOS?

Home Assistant OS: scegli la scheda Home Assistant qui sopra, lì l’agente gira come app. Proxmox: crea una piccola VM Debian o Ubuntu con Docker e segui al suo interno i passaggi per Linux. TrueNAS SCALE, OpenMediaVault e CasaOS: apri una shell via SSH e segui i passaggi per Linux, oppure usa Portainer se ce l’hai.

Ancora problemi?

Nell’app tocca «Segnala un problema» e descrivi cosa succede. Le ultime righe del log aiutano molto: sudo docker logs --tail 30 allmyprinters-agent.