Aller au contenu principal

Installer l'agent

Installez l'agent sur chaque ordinateur ou appareil Android relié à une imprimante. Téléchargez l'installateur depuis Tableau de bord → Téléchargements. Chaque fichier est accompagné d'une somme de contrôle .sha256.

L'installateur crée aussi une autorité de certification locale propre à cette machine et lui fait confiance, pour que les pages web puissent joindre l'agent en wss://localhost. Aucun certificat ni clé privée n'est partagé entre machines.

Windows​

Windows 10 et 11, x64 ou Arm.

  • À la main : lancez JodaPrint-Setup-fr.exe (existe aussi en -en et -ht) et suivez les étapes.

  • En silence : utilisez le MSI. Le code d'activation est facultatif ; vous pouvez aussi activer plus tard.

    msiexec /i JodaPrint-x64.msi /qn ACTIVATION_CODE=KJ74-PX9Q

L'agent tourne comme service Windows JodaPrint, et une icône apparaît dans la zone de notification à l'ouverture de session. Les fichiers vont dans C:\Program Files\JodaPrint, les données (file d'attente, journaux, clé de l'appareil) dans C:\ProgramData\JodaPrint.

macOS​

macOS 13 ou plus récent, Apple silicon ou Intel. Double-cliquez sur JodaPrint.pkg, ou :

sudo installer -pkg JodaPrint.pkg -target /

L'agent tourne comme LaunchDaemon io.jodaprint.agent, et l'icône JodaPrint apparaît dans la barre des menus. L'outil en ligne de commande est lié en /usr/local/bin/jodaprint-agent.

Linux​

Debian et Ubuntu (.deb), Fedora et RHEL (.rpm), amd64 et arm64 :

sudo JODAPRINT_ACTIVATION_CODE=KJ74-PX9Q apt install ./jodaprint-agent_1.2.0_amd64.deb
sudo JODAPRINT_ACTIVATION_CODE=KJ74-PX9Q dnf install ./jodaprint-agent-1.2.0-1.x86_64.rpm

L'agent tourne comme service systemd jodaprint-agent (en root, comme les backends CUPS, pour ouvrir les imprimantes USB et série). L'icône nécessite un bureau compatible StatusNotifier ; sous GNOME, installez l'extension AppIndicator.

Android​

Android 7.0 (API 24) ou plus récent : téléphones, tablettes et terminaux de caisse Android (Sunmi, PAX, iMin, Telpo).

  1. Installez l'application JodaPrint depuis le magasin d'applications de l'appareil, ou l'APK depuis Tableau de bord → Téléchargements. Pour un APK, Android demande une fois d'autoriser « Installer des applications inconnues ».
  2. Ouvrez JodaPrint. Autorisez les notifications et, si l'application le demande, l'exemption d'optimisation de la batterie. L'agent tourne comme service de premier plan avec une notification permanente.
  3. Activez avec le code, ou scannez le QR code affiché dans le tableau de bord.

Les navigateurs Android ne font pas confiance aux certificats locaux : les applications web impriment donc via le shell WebView au lieu de wss://localhost.

Vérifier l'installation​

jodaprint-agent status

La commande indique si le service tourne, s'il est activé et quelles imprimantes il a trouvées. Sous Windows, lancez-la depuis une invite administrateur dans C:\Program Files\JodaPrint.

Pour installer sur de nombreux ordinateurs à la fois, voir Déploiement silencieux.