Pour NAS et Raspberry Pi
Installer l’agent, pas à pas
Choisis ton système, copie chaque ligne en un clic et colle-la. Pas besoin de connaître Docker. Compte environ 10 minutes.
Un appareil toujours allumé
Un mini PC comme un Intel NUC, un NAS (Synology, QNAP, Unraid), un Raspberry Pi 4 ou 5 avec un système 64 bits, ou un PC Linux. Un PC Windows ou un Mac marche aussi, mais il doit rester allumé.
Sur le même réseau que tes imprimantes
Par câble ou en Wi-Fi, relié à la même box.
Environ 10 minutes
Chaque commande a un bouton pour la copier. Tu n’as rien à taper à la main.
Tes réglages
Choisis un mot de passe pour la page web de l’agent. On l’insère dans chaque commande ci-dessous, tu n’as plus qu’à copier-coller. Il reste dans cet onglet du navigateur et n’est envoyé nulle part.
Au moins 6 caractères : lettres, chiffres, - _ . (sans espace), pour que les commandes marchent partout. Laisse 8090, sauf si un autre programme l’utilise déjà.
Utilise seulement des lettres, des chiffres et - _ . avec au moins 6 caractères. En attendant, les commandes affichent « TonMotDePasse ».
Choisis ton système
Tu hésites ? Un mini PC (comme un NUC) ou un Raspberry Pi sous Ubuntu, Debian ou Raspberry Pi OS, c’est « Linux ». Si tu gères déjà tes conteneurs dans Portainer, choisis Portainer.
Linux : mini PC, NUC, Raspberry Pi, serveur maison
Ouvrir un terminal sur l’appareil
Devant l’appareil : ouvre l’app Terminal. Depuis un autre ordinateur : ouvre PowerShell (Windows) ou Terminal (Mac) et connecte-toi en SSH. Remplace
userpar ton nom d’utilisateur sur l’appareil, et les chiffres par son adresse IP (la liste des appareils de ta box l’indique) :À la première connexion, tape
yes. Pendant que tu tapes le mot de passe, rien ne s’affiche à l’écran. C’est normal, appuie simplement sur Entrée.Vérifier que Docker est installé
Colle ceci et appuie sur Entrée :
docker --versionTu vois quelque chose comme
Docker version 27.3.1? Alors passe à l’étape 3. Tu voiscommand not found? Alors installe Docker avec cette ligne, ça prend quelques minutes :curl -fsSL https://get.docker.com | sudo shSur un Raspberry Pi, lance aussi
uname -m. La réponse doit êtreaarch64. Si c’estarmv7l, le Pi tourne sous un système 32 bits : installe d’abord Raspberry Pi OS (64-bit).Démarrer l’agent
Colle cette ligne. Elle contient déjà le mot de passe choisi plus haut. Si
sudodemande un mot de passe, c’est celui de ton utilisateur sur l’appareil :sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAu premier démarrage, l’agent est téléchargé, ce qui peut prendre une minute ou deux. À la fin, tu vois une longue ligne de lettres et de chiffres : c’est que tout a marché.
Vérifier qu’il tourne et trouver l’adresse
Colle ceci :
sudo docker ps --filter name=allmyprinters-agentSous STATUS, tu dois lire
Up, puis(healthy)au bout d’une minute environ. Récupère maintenant l’adresse de l’appareil :hostname -ILe premier nombre, par exemple
192.168.1.50, est l’adresse. Continue plus bas avec « Ouvrir l’agent ».
Mettre à jour plus tard
Lance cette ligne. Elle télécharge la dernière version et redémarre l’agent avec les mêmes réglages. Tes données sont conservées.
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=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestSupprimer l’agent
Arrête et supprime l’agent. Tes données sont conservées, tu peux donc le redémarrer à tout moment :
sudo docker rm -f allmyprinters-agentPour effacer aussi toutes ses données (imprimantes, bobines, historique, bibliothèque). C’est irréversible :
sudo docker volume rm allmyprinters-agentNAS Synology (DSM 7.2 ou plus récent)
Installer Container Manager
Dans DSM, ouvre le Centre de paquets, cherche Container Manager et installe-le. Si ton DSM est plus ancien que la 7.2, mets-le d’abord à jour : avant la 7.2, le paquet s’appelait Docker et ne savait pas créer de projets.
Créer un dossier
Ouvre File Station. Dans le dossier partagé docker (créé par Container Manager), crée un nouveau dossier nommé
allmyprinters-agent.Créer le projet
Ouvre Container Manager → Projet → Créer et remplis :
- Nom du projet :
allmyprinters-agent - Chemin : clique sur Set path et choisis docker → allmyprinters-agent
- Source : Créer docker-compose.yml
Colle ceci dans la zone de texte. Ton mot de passe y est déjà :
services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "TonMotDePasse" AMP_PORT: "8090" AMP_LANG: "fr" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentClique sur Suivant. Laisse le portail web (Web Station) désactivé, clique encore sur Suivant, puis sur Terminé. Container Manager télécharge l’agent et le démarre, ce qui peut prendre une minute ou deux.
- Nom du projet :
Vérifier qu’il tourne
Sous Conteneur,
allmyprinters-agentdoit afficher En cours d’exécution. L’adresse est celle que tu utilises pour ouvrir DSM, sans:5000, par exemple192.168.1.50. Continue plus bas avec « Ouvrir l’agent ».
Mettre à jour plus tard
Container Manager cherche les nouvelles versions environ une fois par jour. Quand Image affiche « Mise à jour disponible » à côté de l’agent, sélectionne-le et choisis Mettre à jour. Container Manager redémarre l’agent avec la nouvelle version, tes données sont conservées.
Supprimer l’agent
Projet → allmyprinters-agent → Action → Arrêter, puis Supprimer. Les données de l’agent restent sur le NAS. Pour les effacer aussi, lance ceci en SSH (irréversible) :
sudo docker volume rm allmyprinters-agentUnraid
Vérifier que Docker est activé
Settings → Docker : « Enable Docker » doit être sur Yes. C’est le cas par défaut.
Ouvrir le terminal
Clique sur l’icône de terminal >_ en haut à droite de l’interface web d’Unraid.
Démarrer l’agent
Colle cette ligne et appuie sur Entrée. Ton mot de passe y est déjà :
docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAu premier démarrage, l’agent est téléchargé. À la fin, tu vois une longue ligne de lettres et de chiffres : c’est que tout a marché.
Vérifier qu’il tourne
Dans l’onglet Docker,
allmyprinters-agentapparaît maintenant comme démarré. Unraid le signale comme conteneur sans template, c’est normal. L’adresse est celle de ton serveur Unraid, par exemple192.168.1.50. Continue plus bas avec « Ouvrir l’agent ».
Mettre à jour plus tard
Le bouton de mise à jour d’Unraid ne marche pas pour les conteneurs démarrés de cette façon. Ouvre plutôt le terminal et lance cette ligne. Tes données sont conservées :
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=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestSupprimer l’agent
Arrête et supprime l’agent. Tes données sont conservées :
docker rm -f allmyprinters-agentPour effacer aussi toutes ses données. C’est irréversible :
docker volume rm allmyprinters-agentPortainer
Ajouter une stack
Connecte-toi à Portainer, choisis ton environnement (en général local) et clique sur Stacks → Add stack.
Coller la configuration
Name :
allmyprinters-agent. Build method : Web editor. Colle ceci dans l’éditeur. Ton mot de passe y est déjà :services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "TonMotDePasse" AMP_PORT: "8090" AMP_LANG: "fr" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentDéployer la stack
Descends en bas de la page et clique sur Deploy the stack. Portainer télécharge l’agent et le démarre, ce qui peut prendre une minute.
Vérifier qu’il tourne
Sous Containers,
allmyprinters-agentdoit afficher running, puis healthy au bout d’une minute environ. L’adresse est l’IP de l’appareil sur lequel tourne Portainer, par exemple192.168.1.50. Continue plus bas avec « Ouvrir l’agent ».
Mettre à jour plus tard
Stacks → allmyprinters-agent → Editor → Update the stack. Dans la fenêtre qui s’ouvre, active Re-pull image and redeploy et confirme. Tes données sont conservées.
Supprimer l’agent
Stacks → coche allmyprinters-agent → Remove. Les données de l’agent restent dans le volume allmyprinters-agent. Pour les effacer aussi, supprime ce volume sous Volumes (irréversible).
PC Windows ou Mac avec Docker Desktop
Docker Desktop ne peut pas donner à l’agent un accès direct à ton réseau. L’agent fonctionne, mais sa recherche ne trouve pas les imprimantes Bambu Lab et Elegoo : ajoute-les avec leur adresse IP. L’ordinateur doit rester allumé et ne pas se mettre en veille, sinon l’agent s’arrête aussi.
Installer Docker Desktop
Déjà installé, par exemple pour un autre conteneur ? Alors saute cette étape. Sinon, télécharge Docker Desktop sur docker.com, installe-le et lance-le.
Ensuite, dans Docker Desktop, ouvre Settings → General et active « Start Docker Desktop when you sign in to your computer », pour que l’agent redémarre tout seul après un redémarrage de l’ordinateur.
Trouver l’adresse de cet ordinateur
Windows : ouvre PowerShell (menu Démarrer, tape « PowerShell ») et lance
ipconfig. Prends l’Adresse IPv4 de ta carte réseau (Ethernet ou Wi-Fi), par exemple192.168.1.50.Mac : Réglages Système → Réseau → ta connexion affiche l’adresse IP.
Saisis-la ici, la commande de l’étape 3 se met à jour toute seule :
Ça ne ressemble pas à une adresse de ton réseau domestique (par ex. 192.168.1.50).
Démarrer l’agent
Colle cette ligne dans PowerShell (Windows) ou dans Terminal (Mac) et appuie sur Entrée. Ton mot de passe et l’adresse y sont déjà :
docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestAu premier démarrage, l’agent est téléchargé, ce qui peut prendre une minute ou deux. Si Windows demande si Docker peut utiliser le réseau, autorise-le pour les réseaux privés.
Vérifier qu’il tourne
Dans Docker Desktop, sous Containers,
allmyprinters-agentdoit apparaître comme démarré. Sur cet ordinateur, tu peux ouvrir l’agent à l’adressehttp://localhost:8090. Continue plus bas avec « Ouvrir l’agent ».
Mettre à jour plus tard
Lance cette ligne dans PowerShell ou Terminal. Elle télécharge la dernière version et redémarre l’agent. Tes données sont conservées :
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=TonMotDePasse -e AMP_PORT=8090 -e AMP_LANG=fr -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestSupprimer l’agent
Arrête et supprime l’agent. Tes données sont conservées :
docker rm -f allmyprinters-agentPour effacer aussi toutes ses données. C’est irréversible :
docker volume rm allmyprinters-agentHome Assistant OS (app)
Il faut Home Assistant OS ou une installation Supervised. Si ton Home Assistant tourne lui-même dans Docker, suis plutôt les étapes Linux sur cette machine. Le champ mot de passe en haut n’est pas nécessaire ici : Home Assistant gère la connexion.
Ajouter le dépôt
Clique sur le bouton. Ton Home Assistant s’ouvre et demande s’il faut ajouter le dépôt AllMyPrinters. Confirme avec Ajouter.
Il faut être connecté à Home Assistant dans ce navigateur. Sinon, ouvre la boutique d’apps dans Home Assistant, ⋮ en haut à droite → Dépôts, et ajoute cette adresse :
https://github.com/nolimitek/ha-allmyprintersInstaller l’app
Recharge la boutique et ouvre AllMyPrinters Agent. Clique sur Installer, puis Démarrer, et active Afficher dans la barre latérale.
L’ouvrir
Clique sur AllMyPrinters dans la barre latérale. C’est l’agent, avec imprimantes, bobines et réglages comme dans l’app. Tu peux sauter « Ouvrir l’agent » plus bas.
En option : entités et tableaux de bord
Pour avoir imprimantes, bobines, caméra et pause/annulation comme entités, installe l’intégration AllMyPrinters dans HACS (dépôt personnalisé, même adresse que ci-dessus, type Intégration) et redémarre Home Assistant. Elle apparaît ensuite dans Paramètres → Appareils et services → Découvert, il suffit de confirmer.
Mettre à jour plus tard
Home Assistant propose les mises à jour dans Paramètres → Mises à jour, comme pour toute autre app. Tes données restent et font partie des sauvegardes de Home Assistant.
Supprimer l’agent
Paramètres → Apps → AllMyPrinters Agent → Désinstaller. Cela supprime aussi les données de l’agent dans Home Assistant. Pour les garder, enregistre d’abord un fichier dans l’agent sous Réglages → Sauvegarde.
Ensuite, quel que soit ton système
Ouvrir l’agent
Sur n’importe quel ordinateur, tablette ou téléphone de ton réseau domestique, ouvre
http://<address>:8090dans le navigateur avec l’adresse trouvée plus haut, par exemplehttp://192.168.1.50:8090. Connecte-toi avec ton mot de passe et ajoute la page à tes favoris.Connecter l’app
Dans l’agent : Plus → Réglages → Associer des appareils → Ajouter un appareil. Un QR code s’affiche, valable 10 minutes.
Dans l’app : Plus → Réglages → Se connecter à l’agent → Scanner le QR code.
L’app te demande ensuite quelles données garder. Si tes imprimantes et tes bobines sont déjà dans l’app, choisis Reprendre les données de l’app : tout passe dans l’agent. Il faut l’app 0.8.1 ou plus récente.
Ajouter d’autres imprimantes
Les imprimantes qui ne sont pas encore dans l’app s’ajoutent dans l’agent, exactement comme dans l’app : la recherche parcourt ton réseau, et le guide de chaque marque te dit quoi activer sur l’imprimante.
En option : accès de partout
Dans l’agent : Plus → Réglages → Accès de partout → Activer. Tes appareils associés joignent alors l’agent aussi en déplacement, et sur un PC ou un iPhone, tu l’ouvres sur allmyprinters.com/web. Tant que tu ne l’actives pas, il reste désactivé, et tout est chiffré de bout en bout.
En option : Home Assistant
Imprimantes, bobines, boîtiers de filament et caméra dans Home Assistant : installe l’intégration AllMyPrinters dans HACS (dépôt personnalisé
https://github.com/nolimitek/ha-allmyprinters, type Intégration). Ajoute-la ensuite dans Paramètres → Appareils et services avec l’adresse de l’agent et la clé de Plus → Réglages → Home Assistant dans l’agent.
Quelque chose ne marche pas ?
« permission denied »
Mets sudo devant la commande. Dans nos commandes Linux, il y est déjà.
« The container name … is already in use »
L’agent est déjà installé. Pour le démarrer avec de nouveaux réglages (par exemple un nouveau mot de passe), supprime d’abord l’ancien conteneur avec sudo docker rm -f allmyprinters-agent (sous Windows, Mac et Unraid, sans sudo). Tes données sont conservées. Relance ensuite la commande de démarrage.
« port is already allocated », ou le journal dit que le port est occupé
Un autre programme utilise déjà le port 8090. Saisis un autre numéro tout en haut, par exemple 8091, supprime le conteneur (voir ci-dessus) et redémarre-le avec la nouvelle commande. Ouvre ensuite l’agent avec le nouveau port.
« no matching manifest » ou « exec format error »
L’appareil tourne sous un système 32 bits, alors que l’agent a besoin du 64 bits. Sur un Raspberry Pi 3, 4 ou 5, installe Raspberry Pi OS (64-bit).
La page ne s’ouvre pas
Vérifie que l’agent tourne (dernière étape pour ton système) et que tu utilises la bonne adresse et le bon port. Le journal dit souvent pourquoi : sudo docker logs --tail 30 allmyprinters-agent. Un pare-feu peut bloquer le port : sous Ubuntu avec ufw, lance sudo ufw allow 8090/tcp. Sur Synology, autorise le port dans Panneau de configuration → Sécurité → Pare-feu.
J’ai oublié le mot de passe
Saisis-en un nouveau tout en haut, supprime le conteneur (tes données sont conservées) et redémarre-le avec la nouvelle commande. Avec Synology ou Portainer, change le mot de passe dans le texte compose, puis mets à jour le projet ou la stack.
La recherche ne trouve pas mon imprimante
Ajoute-la avec son adresse IP. Tu la trouves sur l’écran de l’imprimante ou dans ta box. Sous Windows et Mac, c’est toujours nécessaire pour Bambu Lab et Elegoo.
Home Assistant OS, Proxmox, TrueNAS, OpenMediaVault, CasaOS ?
Home Assistant OS : choisis l’onglet Home Assistant plus haut, l’agent y tourne comme app. Proxmox : crée une petite VM Debian ou Ubuntu avec Docker et suis les étapes Linux dedans. TrueNAS SCALE, OpenMediaVault et CasaOS : ouvre un shell en SSH et suis les étapes Linux, ou passe par Portainer si tu l’as.
Toujours un souci ?
Touche « Signaler un problème » dans l’app et décris ce qui se passe. Les dernières lignes du journal aident beaucoup : sudo docker logs --tail 30 allmyprinters-agent.