nativeInstallererpnext

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 Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

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.

    $ 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