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.
Un dispositivo sempre acceso
Un mini PC come un Intel NUC, un NAS (Synology, QNAP, Unraid), un Raspberry Pi 4 o 5 con sistema a 64 bit oppure un PC Linux. Va bene anche un PC Windows o un Mac, ma deve restare acceso.
Nella stessa rete delle stampanti
Via cavo o Wi-Fi, collegato allo stesso router.
Circa 10 minuti
Ogni comando ha il suo pulsante Copia. Non devi scrivere niente a mano.
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à.
Usa solo lettere, numeri e - _ . con almeno 6 caratteri. Fino ad allora i comandi mostrano «LaTuaPassword».
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
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
usercon 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.Controlla che Docker sia installato
Incolla questa riga e premi Invio:
docker --versionVedi qualcosa come
Docker version 27.3.1? Allora vai al punto 3. Vedicommand not found? Allora installa Docker con questa riga, ci vuole qualche minuto:curl -fsSL https://get.docker.com | sudo shSu un Raspberry Pi esegui anche
uname -m. Deve comparireaarch64. Se comparearmv7l, il Pi ha un sistema a 32 bit: prima installa Raspberry Pi OS (64-bit).Avvia l’agente
Incolla questa riga. Contiene già la password che hai scelto sopra. Se
sudoti 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:latestAl 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.
Controlla che funzioni e trova l’indirizzo
Incolla questa riga:
sudo docker ps --filter name=allmyprinters-agentSotto STATUS deve comparire
Upe, dopo circa un minuto,(healthy). Ora trova l’indirizzo del dispositivo:hostname -IIl 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:latestRimuovere l’agente
Ferma e rimuove l’agente. I tuoi dati restano, quindi puoi riavviarlo quando vuoi:
sudo docker rm -f allmyprinters-agentPer cancellare anche tutti i suoi dati (stampanti, bobine, cronologia, libreria). Non si può annullare:
sudo docker volume rm allmyprinters-agentNAS Synology (DSM 7.2 o successivo)
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.
Crea una cartella
Apri File Station. Nella cartella condivisa docker (l’ha creata Container Manager) crea una nuova cartella chiamata
allmyprinters-agent.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-agentClicca 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.
- Nome progetto:
Controlla che funzioni
In Container,
allmyprinters-agentdeve risultare In esecuzione. L’indirizzo è quello che usi per aprire DSM, senza:5000, per esempio192.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-agentUnraid
Controlla che Docker sia attivo
Settings → Docker: «Enable Docker» deve essere su Yes. Di solito è già attivo.
Apri il terminale
Clicca l’icona del terminale >_ in alto a destra nell’interfaccia web di Unraid.
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:latestAl primo avvio viene scaricato l’agente. Alla fine vedi una lunga riga di lettere e numeri: vuol dire che ha funzionato.
Controlla che funzioni
Nella scheda Docker ora
allmyprinters-agentrisulta avviato. Unraid lo segna come container senza template, va bene così. L’indirizzo è quello del tuo server Unraid, per esempio192.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:latestRimuovere l’agente
Ferma e rimuove l’agente. I tuoi dati restano:
docker rm -f allmyprinters-agentPer cancellare anche tutti i suoi dati. Non si può annullare:
docker volume rm allmyprinters-agentPortainer
Aggiungi uno stack
Accedi a Portainer, scegli il tuo ambiente (di solito local) e clicca Stacks → Add stack.
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-agentAvvialo
Scorri in basso e clicca Deploy the stack. Portainer scarica l’agente e lo avvia, può volerci un minuto.
Controlla che funzioni
In Containers,
allmyprinters-agentdeve risultare running e, dopo circa un minuto, healthy. L’indirizzo è l’IP del dispositivo su cui gira Portainer, per esempio192.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.
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.
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 esempio192.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:
Non sembra un indirizzo della tua rete di casa (es. 192.168.1.50).
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:latestAl 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.
Controlla che funzioni
In Docker Desktop, sotto Containers,
allmyprinters-agentdeve risultare in esecuzione. Su questo computer apri l’agente all’indirizzohttp://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:latestRimuovere l’agente
Ferma e rimuove l’agente. I tuoi dati restano:
docker rm -f allmyprinters-agentPer cancellare anche tutti i suoi dati. Non si può annullare:
docker volume rm allmyprinters-agentHome 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.
Aggiungi il repository
Clicca il pulsante. Si apre il tuo Home Assistant e chiede se aggiungere il repository di AllMyPrinters. Conferma con Aggiungi.
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-allmyprintersInstalla l’app
Ricarica lo store e apri AllMyPrinters Agent. Clicca Installa, poi Avvia, e attiva Mostra nella barra laterale.
Aprila
Clicca AllMyPrinters nella barra laterale. È l’agente, con stampanti, bobine e impostazioni come nell’app. Puoi saltare «Apri l’agente» più sotto.
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
Apri l’agente
Da qualsiasi computer, tablet o telefono della tua rete di casa, apri nel browser
http://<address>:8090con l’indirizzo del dispositivo, per esempiohttp://192.168.1.50:8090. Accedi con la tua password e salva la pagina nei preferiti.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.
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.
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.
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.