Ajouter un serveur d'impression Raspberry Pi à votre compte

Un Raspberry Pi équipé de l'image Expedy est un serveur d'impression cloud : il reçoit les travaux envoyés à Expedy PRINT et les transmet à une imprimante ESC/POS branchée sur son port USB. Jusqu'à quatre imprimantes peuvent partager le même Raspberry Pi.

Selon le connecteur ou le logiciel de caisse utilisé, l'installation peut être réalisée par votre partenaire. Rapprochez-vous de lui avant de commencer.

Avant de commencer

• Un compte Expedy, pas encore de compte ? Créez-en un
• Un Raspberry Pi Zero ou 4 flashé avec l'image Expedy, voir Installation sur Raspberry Pi
• Votre imprimante branchée sur le port USB1, et le Raspberry Pi relié à votre routeur

Étape 1, Ouvrir l'écran d'ajout de machine

Connectez-vous à la console Expedy, puis allez dans Machines, Ajouter une machine. Vous pouvez aussi ouvrir le formulaire directement.

Étape 2, Obtenir le numéro de série

Le numéro de série est ce qui rattache la machine à votre compte. Il a toujours la forme RPI_ suivi de 40 caractères hexadécimaux. Deux cartes vous laissent choisir sa provenance :

Générer un nouveau est le parcours normal pour une installation neuve. La console vérifie que la valeur est libre sur l'ensemble des comptes avant de vous la proposer : il n'y a rien à demander au support. Recopiez le numéro généré dans le fichier rpi_id.txt du volume boot de la carte SD, c'est lui qui permet au Raspberry Pi de retrouver votre compte au premier démarrage.

Étape 3, Nommer la machine et valider

Cliquez sur Valider. Trois erreurs peuvent apparaître :

• Format de numéro de série invalide, la valeur ne commence pas par RPI_
• Ce numéro de série est déjà utilisé, générez-en un autre
• Cet appareil est déjà rattaché à un autre compte, contactez le support

Étape 4, Vérifier la machine et scanner les ports USB

Ouvrez la machine depuis votre liste et cliquez sur Vérifier le statut. Pour un Raspberry Pi, la console interroge la machine via l'API et renvoie En ligne ou Hors ligne. Si elle reste hors ligne, contrôlez le câble réseau et l'ouverture du port 1883 sur votre routeur.

Ouvrez ensuite la carte Paramètres Raspberry Pi et cliquez sur Scan USB. La grille Ports USB liste ce qui est branché sur USB 1 à USB 4, avec le fabricant, le modèle et la largeur de papier. Un port sans rien de branché affiche Libre.

Chaque port détecté expose ensuite son mode d'impression, ESC/POS ou LABEL, sa largeur de papier et son mode graphique. Détails dans Installation sur Raspberry Pi.

Enfin, lancez un Test d'impression rapide depuis le panneau Historique des impressions.

Les plugins et Zapier utilisent USB 1 par défaut. Les intégrations API sur mesure peuvent viser n'importe quel port USB, c'est ainsi qu'un seul Raspberry Pi pilote jusqu'à quatre imprimantes.

Le formulaire imprimantes, pour un appareil préprovisionné

/console/v3/printers/add propose aussi une carte Raspberry Pi. Son aide demande un numéro fourni par le support Expedy : n'empruntez ce chemin que si le support a préprovisionné votre appareil. Dans tous les autres cas, le parcours Machines ci-dessus génère lui-même le numéro.

Lever la limite du compte FREE

Un appareil nouvellement ajouté fonctionne sur l'offre FREE, plafonnée à 50 requêtes d'impression par mois. Pour aller au-delà, ouvrez sa page et cliquez sur Souscrire pour accéder à l'écran Choisissez votre offre.

Les tarifs en vigueur sont affichés sur expedy.io/pricing et dans l'écran Choisissez votre offre.

Les appareils installés avant le 30 avril 2026 sans abonnement portent la mention LEGACY. Ils conservent leur tarification historique, n'ont aucune limite mensuelle, et l'écran de souscription leur est masqué. Pour basculer un appareil LEGACY sur une offre actuelle, contactez le support.

Aller plus loin

• Brancher une imprimante ESC/POS sur l'adaptateur
• Connexion par câble Ethernet et WiFi
• Connecter votre boutique en ligne ou vos plateformes de livraison

Une question ? Ouvrez un ticket au support