Configure printers on Windows

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

• Administrator access to the machine.
• Thermal printer already installed in Windows (visible in Devices and Printers).
• PowerShell available (included in Windows 10 and 11).
• Internet connection.

Open PowerShell as administrator and run the Recompry installation script:

PowerShell -ExecutionPolicy Bypass -File .\scripts\install-qz-windows.ps1

If you already downloaded the QZ Tray .exe installer manually, you can specify the path:

PowerShell -ExecutionPolicy Bypass -File .\scripts\install-qz-windows.ps1 -InstallerPath .\qz-tray.exe

If QZ Tray is already installed and you only need to add the certificate for silent printing, run:

PowerShell -ExecutionPolicy Bypass -File .\scripts\qz-provision-own-root-windows.ps1 -RootCertPath .qz\root-ca.crt

1. Open QZ Tray if it is not running (it will appear in the system tray).
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.

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.

Set up zones to automatically route orders to different printers by area (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.

If QZ Tray does not connect or no printers appear:

1. Verify QZ Tray is running in the system tray (bottom-right corner).
2. Check that your antivirus or firewall is not blocking localhost:8181 or localhost:8182.
3. Restart QZ Tray from the system tray.
4. Go back to Settings > Printing and click Refresh.