Recompry
ESEN
Sign inGet started
Help center/Configuration
20 min

Configure printers on macOS

Install QZ Tray, connect your thermal printer, and set up print zones on macOS.

In this guide
  1. What you need
  2. Install QZ Tray
  3. Provision the Recompry certificate
  4. Connect in Recompry
  5. Test printing
  6. Configure print zones
  7. Troubleshooting

What you need

Before starting, make sure you have the following on the macOS machine:

  • Administrator access to the machine.
  • Thermal printer already installed in macOS (visible in System Printers).
  • Internet connection to download QZ Tray.

Install QZ Tray

QZ Tray is the application that connects your browser to local printers without browser extensions.

  1. Open Terminal on your Mac.
  2. Run the quick install command:
bash
curl qz.sh | bash

Alternatively, download the .pkg installer from qz.io and install it manually.

Provision the Recompry certificate

For silent printing (no security warnings), you need to install the Recompry certificate into QZ Tray. Request the installation script from your support team and run:

bash
sudo ./scripts/install-qz-macos.sh
ℹ

If macOS blocks the script with 'Operation not permitted', go to System Preferences > Privacy & Security and grant Terminal permission to manage applications.

Connect in Recompry

  1. Open QZ Tray if it is not running (it will appear in the menu bar).
  2. Sign in to Recompry and go to Settings > Printing.
  3. Select the location you are configuring.
  4. Under Printer selection, switch to QZ Tray.
  5. Click Refresh to detect available printers.
  6. Select your thermal printer from the list.
  7. Set the Paper width (usually 80 mm).
  8. Define whether each template should open the cash drawer.

Test printing

  1. In the Templates section, find the template you want to test (Order, Pre-bill, Invoice).
  2. Click the printer icon next to each template.
  3. Verify the ticket prints correctly.
ℹ

If QZ Tray shows a trust warning the first time, accept it and check 'Remember this decision'.

Configure print zones

Print zones let you automatically route orders to different printers based on product type (kitchen, bar, cashier).

  1. Go to Settings > Printing > Print zones.
  2. Click Create zone.
  3. Name the zone (e.g., Kitchen, Bar).
  4. Assign the corresponding printer.
  5. Save your changes.

Troubleshooting

If QZ Tray does not connect or no printers appear:

  1. Fully quit QZ Tray from the menu bar.
  2. Reopen it.
  3. Go back to Settings > Printing and click Refresh.
  4. If the problem persists, verify the printer is on and visible in System Preferences > Printers.
Sales & Support