1. Node.js installation and version.
    1. In order to use image export capability you must have Node.js installed on your server. Please go to this page for more instructions.
      It's crucial to use Node.js starting from version 8.16.2 or above.


  2. NPM installation and version.
    1. Execute command npm -v on the machine where Jira Server is running. This command should return a NPM version number.
    2. If above command returns error then you probably don't have NPM installed correctly. NPM should be installed with Node.js and if it's not try to reinstall Node.js using the link from first point.
      It's crucial to use NPM starting from version 6.4.1 or above.


  3. Puppeteer visibility.
    1. Go to node global module directory (NGMD) ( you can execute the following command:  npm root --quiet -g to get global module directory path ).
    2. In NGMD you should have puppeteer dir, enter this directory.
    3. Execute command: npm link puppeteer 
    4. Go to your Jira Temp dir ( if you don't know the path go to Getting the path of Jira temp directory section below )
    5. Execute command: npm link puppeteer 


  4. Temp directory write permission.
    1. Go to your Jira Temp dir ( if you don't know the path go to Getting the path of Jira temp directory section below )
    2. Make sure that the user who runs Jira ( by default it is a user named Jira ) has permissions to create files in this directory.
    3. Execute the following command: chmod +w path/to/temp/dir


  5. Temp directory read permission.
    1. Go to your Jira Temp dir ( if you don't know the path go Getting the path of Jira temp directory section below )
    2. Make sure that the user who runs Jira ( by default it is a user named Jira ) has permissions to create files in this directory.
    3. Execute the following command: chmod +r path/to/temp/dir

If you experience any problems with the export to PDF using BigTemplate feel free to contact our Support Team using our Service Desk Portal or by sending an email to support@softwareplant.com



Getting the path of Jira temp directory:

  1. Go to Jira → System → System Info
  2. Search for the following text: java.io.tmpdir
  3. Value of this property is temp directory path, e.g. /opt/atlassian/jira/temp