nativeInstallerodoo

Install the Wkhtmltopdf extension

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

To install Wkhtmltopdf on your system, follow the steps described below.

Linux and OS X

  • Download the latest version of the package from the Wkhtmltopdf project releases page and install it. Replace the X.Y.Z placeholders with the latest version available for your platform.

    NOTE: The latest version available of Wkhtmltopdf is not compatible with some Odoo functionalities in some Linux distributions. Please check what is the recommended version for your Linux distribution in the Odoo GitHub repository.

    $ wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/X.Y.Z/wkhtmltox-X.Y.Z_linux-generic-amd64.tar.xz
    $ tar -xvf wkhtmltox-X.Y.Z_linux-generic-amd64.tar.xz
    
  • Copy the binaries to the /usr/bin directory:

    $ sudo cp ./wkhtmltox/bin/wkhtmltoimage /usr/bin/
    $ sudo cp ./wkhtmltox/bin/wkhtmltopdf /usr/bin/
    
  • Install the necessary dependencies:

    • Debian:

      $ sudo apt-get install zlib1g fontconfig libxrender1 libfreetype6 libxext6 libx11-6
      
    • CentOS:

      $ sudo yum install zlib-devel fontconfig libXext libXrender freetype freetype-devel libX11-devel
      
  • Restart all running servers:

    $ sudo installdir/ctlscript.sh restart
    $ sudo installdir/ctlscript.sh restart apache
    

PDF options will now be available in your application.

Troubleshooting

If you experience issues with display resolution on Linux platforms, they could be related to the xfonts-75dpi or xfonts-100dpi packages. Uninstall them by executing:

$ sudo dpkg --remove --force-depends xfonts-75dpi
$ sudo dpkg --remove --force-depends xfonts-100dpi

Windows

  • Download the latest version of the package from the Wkhtmltopdf project releases page.
  • Uncompress the downloaded archive and add the wkhtmltox\bin directory to your system path.
  • Restart all running servers.

PDF options will now be available in your application.

Last modification December 21, 2018