Install GroupDocs.Conversion for Node.js via Java Leave feedback

• Node.js: 20 LTS or later
• Java: JRE/JDK 8+ (recommended 17 LTS)
• Build tools if needed by your environment (node-gyp toolchain)

See full details on the System Requirements page.

All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager:

# npm
npm install @groupdocs/groupdocs.conversion

# yarn
yarn add @groupdocs/groupdocs.conversion

# pnpm
pnpm add @groupdocs/groupdocs.conversion

Ensure your Java installation is available on PATH and JAVA_HOME is set.

Windows (PowerShell):

$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"

Linux/macOS (Bash):

export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"

See the System Requirements page for more details.

Create a small script (e.g., check.js) and run it with Node.js:

try {
  const conversion = require('@groupdocs/groupdocs.conversion');
  console.log('GroupDocs.Conversion loaded:', typeof conversion === 'object');
  console.log('Java bridge initialized successfully.');
} catch (e) {
  console.error('Failed to load GroupDocs.Conversion:', e);
  process.exit(1);
}

And then run the script to verify the installation:

node check.js

You can download a package archive from GroupDocs.Releases and add it to your app. After downloading the .tar file, install it locally:

npm install ./groupdocs-conversion-<version>.tar

Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command.

• node-gyp toolchain not found: install the required build tools for your OS (see System Requirements).
• Java not detected: set JAVA_HOME and add <JAVA_HOME>/bin to PATH.
• Corporate proxy: configure npm proxy settings before running install.
• Permission errors: ensure you have write access to the project directory and cache folders.