Installation on Raspberry Pi

Installing Expedy Cloud Print Server on Raspberry Pi

Transform your Raspberry Pi Zero or 4 into a Cloud Print Server. Connect a USB printer, plug in to your network, and start sending print jobs from any application or API.

Raspberry Pi Cloud Print Server

You have purchased an Expedy Raspberry Pi SD card or the IMG.GZ download file, compatible with Raspberry Pi Zero and 4 — all versions. Thank you for your trust! 😊

ℹī¸ Using a Raspberry Pi 1, 2, 3 or 5? Contact us

Already have a pre-installed SD card? Skip directly to Step 4 — Start RPI.

1. Download the IMG.GZ file

Download the Expedy image file from your order confirmation or directly from the product page.

2. Install Raspberry Pi Imager

Download: https://www.raspberrypi.com/software/

Raspberry Pi Imager

  1. Insert a new SD card into your computer (minimum 8 GB)
  2. Raspberry Pi Device — Leave empty
  3. Operating System — Select Use Custom and choose the downloaded .img.gz file
  4. Storage — Select your SD card
  5. Click Write — if Raspberry Pi Imager offers to apply custom settings, select No

Imager write screen

3. Enter your API key

  1. Insert the SD card into your computer
  2. Open the boot volume on the SD card
  3. Edit the rpi_id.txt file and enter the unique RPI ID key received by email — Buy a key
  4. Save the file and safely eject the SD card

4. Start RPI

  1. Insert the SD card into your Raspberry Pi Zero or 4
  2. Connect the Raspberry Pi to your router via Ethernet cable
  3. Connect your printer to the USB1 port
  4. Power up the Raspberry Pi

5. Printer settings

Printer settings console

  1. Log in to https://www.expedy.fr/console/
  2. Go to the Machines section and select your device
  3. Check that the PING shows the current date — this confirms a successful connection to the Expedy server
  4. In Print Service, click USB Scan
  5. Select your printer type:
Type Description
ESC/POS Receipt printers with ESC/POS commands (Epson TM, Star TSP143...). Supported formats: TEXT, QR Code, GTIN, JPG, BMP, PNG, PDF. Recommended — standard protocol, no driver required.
LABEL Other printers (laser, inkjet, label, photo). Driver installation required. Supported formats: JPG, BMP, PNG, PDF
  1. Click Save

6. Connect your application

Frequently asked questions

The PING doesn't show the current date — what should I check?

  • Verify the network connection
  • Make sure the RPI ID key is correctly entered in rpi_id.txt
  • Check that port 1883 is open on your router. Most standard internet boxes have it open by default — contact your network provider if you don't have router access

The Raspberry Pi is connected and the printer is recognized, but nothing prints?

  • Go to Printers → Select printer → Print Jobs History and check for API requests
  • Check the USB connection on the USB1 port — plugins and Zapier use USB1 by default. In custom integrations, you can target any USB port and connect up to 4 printers on the same Raspberry Pi

Can the Raspberry Pi connect via Wi-Fi?

Yes, Wi-Fi is supported. For further details, contact us.

Expedy Raspberry Pi setup