Skip to main content
Help us improve Python packaging – donate today!

Let the fusion server handle format conversion.

Project Description

License: AGPL-3

Py3o Report Engine - Fusion server support

This module was written to let a py3o fusion server handle format conversion instead of local libreoffice.


Install several additional components and Python libs:

  • Py3o Fusion server,
  • Py3o render server,
  • a Java Runtime Environment (JRE), which can be OpenJDK,
  • Libreoffice started in the background in headless mode,
  • the Java driver for Libreoffice (Juno).

It is also possible to use the Python driver for Libreoffice (PyUNO), but it is recommended to use the Java driver because it is more stable.

The installation procedure below uses the Java driver. It has been successfully tested on Ubuntu 16.04 LTS ; if you use another OS, you may have to change a few details.

Installation of py3o.fusion:

pip install py3o.fusion
pip install service-identity

Installation of py3o.renderserver:

pip install py3o.renderserver

Installation of Libreoffice and JRE on Debian/Ubuntu:

sudo apt-get install default-jre ure libreoffice-java-common libreoffice-writer

You may have to install additionnal fonts. For example, to have the special unicode symbols for phone/fax/email in the PDF reports generated by Py3o, you should install the following package:

sudo apt-get install fonts-symbola

At the end, with the dependencies, you should have the following py3o python libs:

% pip freeze | grep py3o

Start the Py3o Fusion server:

start-py3o-fusion --debug -s localhost

Start the Py3o render server:

start-py3o-renderserver --java=/usr/lib/jvm/default-java/jre/lib/amd64/server/ --ure=/usr/share --office=/usr/lib/libreoffice --driver=juno --sofficeport=8997

On the output of the Py3o render server, the first line looks like:

DEBUG:root:Starting JVM: /usr/lib/jvm/default-java/jre/lib/amd64/server/ with options: -Djava.class.path=/usr/local/lib/python2.7/dist-packages/py3o/renderers/juno/py3oconverter.jar:/usr/share/java/juh.jar:/usr/share/java/jurt.jar:/usr/share/java/ridl.jar:/usr/share/java/unoloader.jar:/usr/share/java/java_uno.jar:/usr/lib/libreoffice/program/classes/unoil.jar -Xmx150M

After -Djava.class.path, there is a list of Java libs with .jar extension ; check that each JAR file is really present on your filesystem. If one of the jar files is present in another directory, create a symlink that points to the real location of the file. If all the jar files are present on another directory, adapt the –ure= argument on the command line of Py3o render server.

To check that the Py3o Fusion server is running fine, visit the URL http://<IP_address>:8765/form. On this web page, under the section Target format, make sure that you have a line This server currently supports these formats: ods, odt, docx, doc, html, docbook, pdf, xls..

Known issues / Roadmap

  • none yet

Bug Tracker

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 smashing it by providing a detailed and welcomed feedback.



Do not contact contributors directly about help with questions or problems concerning this addon, but use the community mailing list or the appropriate specialized mailinglist for help, and the bug tracker linked in Bug Tracker above for technical issues.


Odoo Community Association

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.

To contribute to this module, please visit

Release history Release notifications

This version
History Node

History Node

History Node

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
odoo10_addon_report_py3o_fusion_server- (116.9 kB) Copy SHA256 hash SHA256 Wheel py2 Mar 27, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page