This module adds support for printing Odoo reports directly from the client machine using QZ Tray as a printing backend.
It allows reports to be sent securely to locally installed printers without relying on server-side printing systems such as CUPS. Instead, printing is handled on the client side through QZ Tray, enabling direct access to USB, network, or system printers.
This backend is especially useful in environments where client-side printing is required, such as Point of Sale setups, kiosk systems, or deployments where the Odoo server does not have access to the printers used by end users.
Table of contents
This module requires QZ Tray to be installed and properly configured on the client machine, as well as additional setup on the Odoo server to enable secure communication.
Download and install QZ Tray on every client that will send print jobs:
Make sure QZ Tray is running before attempting to print from Odoo.
pyOpenSSL is required to sign the messages sent to QZ Tray. This avoids security warnings and allows trusted communication.
sudo pip3 install pyOpenSSL
If you are using a virtual environment, make sure to install it inside that environment.
Generate a self-signed certificate that will be used by Odoo to sign QZ Tray messages.
When prompted for:
Common Name (e.g. server FQDN or YOUR name) []:
You must enter your Odoo domain name.
You can also use a wildcard domain, for example:
*.my-odoo-domain.com
Generate the certificate with:
openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 3650 -nodes
This will generate two files:
cert.pem → public certificate
key.pem → private key
Log in to Odoo with administrator privileges and enable developer mode. Then go to:
Create the following parameters:
| Key | Value |
|---|---|
| qz.certificate | Content of cert.pem (full text) |
| qz.key | Content of key.pem (full text) |
Make sure to copy the full contents, including the BEGIN and END lines.
On the client machine:
This step authorizes your Odoo server to send signed print jobs to QZ Tray.
This document explains how to configure the base_report_to_printer_qz module before using it. It is intended for users with administration privileges.
The module relies on printers configured in Odoo that use the QZ Tray backend.
The print jobs will be sent to the locally installed printer whose name matches the configured printer name in Odoo.
You can define which printer is used by default at different levels.
User-level settings will always take precedence over report-level settings.
Ensure the following on each client machine:
Once these steps are completed, reports configured to be sent to the printer will be printed through QZ Tray without further user interaction.
Guidelines for use:
- To print a report on a specific printer or tray, you can change these in Settings > Printing > Reports to define default behaviour.
- To print a report on a specific printer and/or tray for a user, you can change these in Settings > Printing > Reports in Specific actions per user
- Users may also select a default action, printer or tray in their preferences.
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
This module is part of the OCA/report-print-send project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.