Skip to main content
Open Source Only

This documentation is applicable only for IceHrm Open Source.

PDF Download Configuration

IceHrm uses WKHTMLTOPDF for generating PDF documents such as reports, payslips, and letters.

Installing WKHTMLTOPDF​

On Debian/Ubuntu:​

# Install dependencies
sudo apt-get install -y xfonts-75dpi xfonts-base

# Download WKHTMLTOPDF (check for latest version)
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb

# Install the package
sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb

# Fix any dependency issues
sudo apt-get install -f

Configure IceHrm to Use WKHTMLTOPDF​

After installation, configure the path in IceHrm:

  1. Navigate to System > Settings
  2. Find the System: PDF Export Binary Path setting
  3. Set the value to the WKHTMLTOPDF binary path:
/usr/local/bin/wkhtmltopdf

Verify Installation​

Test that WKHTMLTOPDF is working:

wkhtmltopdf --version

You should see output similar to:

wkhtmltopdf 0.12.6.1 (with patched qt)