Skip to main content
All CollectionsPrinter SetupMac Printers
How to Set Up an Epson Printer with macOS
How to Set Up an Epson Printer with macOS

Step-by-step guide to set up your Epson printer with macOS, including advanced settings, driver installation, and CleanCloud integration.

George avatar
Written by George
Updated this week

⚠️ Warning ⚠️

  • This guide should not be used with Epson TM-m30 using an Ethernet Connection.

  • Ethernet connections may be unstable and interfere with integrated payments. We recommend using a USB connection for reliability.

Getting Started

Enable Advanced Printer Settings

  1. Open Terminal: Press ⌘ + Space, type Terminal, then select it from the list.

  2. Enable Web Interface: Enter "sudo cupsctl WebInterface=yes" and press Enter.

  3. Enter Password: Enter your password when prompted.


Add Your Printer

  1. Open Web Browser: Go to http://localhost:631.

  2. Add Printer:

    • Click Administration > Add Printer.

    • For Ethernet printers: Enter socket://[IP Address]:9100.

    • For USB printers: Use the command lpinfo -v | grep usb: in Terminal to find the appropriate USB path.

    • Enter a Name, Description, and Location for your printer (e.g., CC_Receipt).

    • Do not share the printer, then click Continue.

    • Select Raw as the Make, then click Add Printer.

  3. Set Default Options:

    • Set Starting Banner and Ending Banner to none.

    • Click Set Default Options.


Add a Printer Class

  1. Add Class: Go to Administration > Add Class.

  2. Enter Class Information:

    • Provide a different name for the class (e.g., CC_Receipt_Class).

    • Select the raw printer under Members, then click Add Class.


Download and Install QZTray

  1. Download QZTray: Get the latest version from https://qz.io/download/.

  2. Run Installer: Follow the installation wizard.

    • If prompted, install Java, then complete the QZTray installation.

  3. QZTray in System Tray: Once installed, QZTray will appear in your system tray.


Add Printer to CleanCloud

  1. Login to CleanCloud: Go to Settings → Hardware.

  2. Configure Printer:

    • Select Epson from the printer drop-down menu.

    • Enter the printer class name (e.g., CC_Receipt_Class).

    • Enable auto-print options if needed.

  3. Update and Test: Press Update. Your printer is now ready—test it with an order!


🛟 Need more help?

Explore our Help Center articles for answers. Contact us for further assistance.

Did this answer your question?