Printer Configuration

Requirements

Make sure you have:

  • ✅ Chrome installed
  • ✅ IP Scanner downloaded and opened
  • ✅ A printer with a supported driver

Supported drivers

Printer type Drivers (in order of preference)
Desktop printers PostScript → PCL 5e → PCL 6/PCL XL
Zebra printers Zebra ZPL

🖨️ Add Printer to CUPS

Step 1: Find Raspberry Pi

  1. Scan the network with IP Scanner
  2. Find the device whose MAC address starts with B8

Step 2: Open CUPS

  1. Go to https://<IP-address>:631
  2. Click on Administration
  3. Log in with the provided credentials

Step 3: Add printer

  1. Click Add Printer
  2. Select LPD/LPR Host or Printer
  3. Enter the connection URL: socket://<printer IP address>
  4. Click Continue

Step 4: Configure printer

Choose name: | Printer type | Naming | Example | |-------------|--------|---------| | Desktop | PRINTER_<LOCATION> | PRINTER_WAREHOUSE | | Zebra | ZEBRA_<LOCATION> | ZEBRA_WAREHOUSE |

⚠️ Always use uppercase!

Select make and model: | Printer type | Make | Model | |-------------|------|-------| | Desktop | Generic | Generic PostScript Printer (en) | | Zebra | Zebra | Zebra ZPL Label Printer (en) |

Step 5: Test

  1. Click Set Default Options
  2. Open MaintenancePrint Test Page
  3. Not working? Go to AdministrationModify Printer and try a different driver

📋 Add Printer to EasyFlor

  1. Open EasyFlorAdminPrinters
  2. Click Add and fill in:
Field Desktop printer Zebra printer
Name Printer Warehouse Zebra Warehouse
Description Used for invoicing Used for labels
Printer name PRINTER_WAREHOUSE ZEBRA_WAREHOUSE
Mode Pdf Raw
Print size A4 Label
  1. Click Save
  2. ✅ Test by printing a label or invoice

🔧 Troubleshooting: Printer is not printing

Is the printer not working? Go through this checklist:

  1. Check the default printer for the user — Go to Admin → Users → select the user → Default printers. Is a printer selected? Is it the correct printer? More information: Creating a user and employee
  2. Check if the printer is active in CUPS — Go to https://<IP-address>:631 and check if the printer is not paused or in error state
  3. Print a test page from CUPS — Maintenance → Print Test Page. Does this work? Then the printer is physically fine and the problem is in the EasyFlor settings
  4. Check the printer name — The printer name in EasyFlor must exactly match the name in CUPS (watch the uppercase letters!)
  5. Try a different driver — Go to Administration → Modify Printer in CUPS and try a different driver (PostScript → PCL 5e → PCL 6)

Do you have questions or need help? Feel free to contact us by phone at +31 (0)71 30 20 310 or send an email to support@easyflor.nl.