AllMyPrinters

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.

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

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

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

  2. Vérifier que Docker est installé

    Colle ceci et appuie sur Entrée :

    docker --version

    Tu vois quelque chose comme Docker version 27.3.1 ? Alors passe à l’étape 3. Tu vois command not found ? Alors installe Docker avec cette ligne, ça prend quelques minutes :

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

    Sur un Raspberry Pi, lance aussi uname -m. La réponse doit être aarch64. Si c’est armv7l, le Pi tourne sous un système 32 bits : installe d’abord Raspberry Pi OS (64-bit).

  3. Démarrer l’agent

    Colle cette ligne. Elle contient déjà le mot de passe choisi plus haut. Si sudo demande 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:latest

    Au 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é.

  4. Vérifier qu’il tourne et trouver l’adresse

    Colle ceci :

    sudo docker ps --filter name=allmyprinters-agent

    Sous STATUS, tu dois lire Up, puis (healthy) au bout d’une minute environ. Récupère maintenant l’adresse de l’appareil :

    hostname -I

    Le 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:latest
Supprimer 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-agent

Pour effacer aussi toutes ses données (imprimantes, bobines, historique, bibliothèque). C’est irréversible :

sudo docker volume rm allmyprinters-agent

NAS Synology (DSM 7.2 ou plus récent)

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

  2. Créer un dossier

    Ouvre File Station. Dans le dossier partagé docker (créé par Container Manager), crée un nouveau dossier nommé allmyprinters-agent.

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

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

  4. Vérifier qu’il tourne

    Sous Conteneur, allmyprinters-agent doit afficher En cours d’exécution. L’adresse est celle que tu utilises pour ouvrir DSM, sans :5000, par exemple 192.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-agent

Unraid

  1. Vérifier que Docker est activé

    Settings → Docker : « Enable Docker » doit être sur Yes. C’est le cas par défaut.

  2. Ouvrir le terminal

    Clique sur l’icône de terminal >_ en haut à droite de l’interface web d’Unraid.

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

    Au 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é.

  4. Vérifier qu’il tourne

    Dans l’onglet Docker, allmyprinters-agent apparaît maintenant comme démarré. Unraid le signale comme conteneur sans template, c’est normal. L’adresse est celle de ton serveur Unraid, par exemple 192.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:latest
Supprimer l’agent

Arrête et supprime l’agent. Tes données sont conservées :

docker rm -f allmyprinters-agent

Pour effacer aussi toutes ses données. C’est irréversible :

docker volume rm allmyprinters-agent

Portainer

  1. Ajouter une stack

    Connecte-toi à Portainer, choisis ton environnement (en général local) et clique sur Stacks → Add stack.

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

  4. Vérifier qu’il tourne

    Sous Containers, allmyprinters-agent doit afficher running, puis healthy au bout d’une minute environ. L’adresse est l’IP de l’appareil sur lequel tourne Portainer, par exemple 192.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.

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

  2. 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 exemple 192.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 :

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

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

  4. Vérifier qu’il tourne

    Dans Docker Desktop, sous Containers, allmyprinters-agent doit apparaître comme démarré. Sur cet ordinateur, tu peux ouvrir l’agent à l’adresse http://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:latest
Supprimer l’agent

Arrête et supprime l’agent. Tes données sont conservées :

docker rm -f allmyprinters-agent

Pour effacer aussi toutes ses données. C’est irréversible :

docker volume rm allmyprinters-agent

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

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

    Ajouter à Home Assistant

    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-allmyprinters
  2. Installer l’app

    Recharge la boutique et ouvre AllMyPrinters Agent. Clique sur Installer, puis Démarrer, et active Afficher dans la barre latérale.

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

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

  1. Ouvrir l’agent

    Sur n’importe quel ordinateur, tablette ou téléphone de ton réseau domestique, ouvre http://<address>:8090 dans le navigateur avec l’adresse trouvée plus haut, par exemple http://192.168.1.50:8090. Connecte-toi avec ton mot de passe et ajoute la page à tes favoris.

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

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

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

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