# Install GroupDocs.Viewer for Node.js via Java Install GroupDocs.Viewer for Node.js via Java using npm or an offline package. Includes prerequisites, Java setup, verification, and troubleshooting. ### Prerequisites - 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]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) page. ### Install from npm All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager: ```bash # npm npm install @groupdocs/groupdocs.viewer # yarn yarn add @groupdocs/groupdocs.viewer # pnpm pnpm add @groupdocs/groupdocs.viewer ``` ### Set up Java (JAVA_HOME) Ensure your Java installation is available on PATH and `JAVA_HOME` is set. Windows (PowerShell): ```powershell $env:JAVA_HOME="C:\Program Files\Java\jdk-17" $env:Path="$env:JAVA_HOME\bin;$env:Path" ``` Linux/macOS (Bash): ```bash export JAVA_HOME=/usr/lib/jvm/java-17 export PATH="$JAVA_HOME/bin:$PATH" ``` See the [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) page for more details. ### Verify installation Create a small script (e.g., `check.js`) and run it with Node.js: {{< tabs "check-installation" >}} {{< tab "check.js" >}} ```js import { Viewer } from '@groupdocs/groupdocs.viewer'; try { console.log('GroupDocs.Viewer loaded:', typeof Viewer === 'function'); console.log('Java bridge initialized successfully.'); process.exit(0); } catch (e) { console.error('Failed to load GroupDocs.Viewer:', e); process.exit(1); } ``` {{< /tab >}} {{< /tabs >}} And than run the script to verify the installation: ```bash node check.js ``` ### Download from GroupDocs.Releases (offline) You can download a package archive from [GroupDocs.Releases](https://releases.groupdocs.com/viewer/nodejs-java/#direct-download) and add it to your app. After downloading the `.tar` file, install it locally: ```bash npm install ./groupdocs-groupdocs.viewer-.tar ``` Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command. ### Minimal JavaScript app example Once you have installed the GroupDocs.Viewer package, here's a minimal example of how you can use it in a Node.js application. 1. **Create a JavaScript file** (e.g., `app.js`) in your project's root directory. 2. **Import the GroupDocs.Viewer module** and implement a simple file viewing functionality: {{< tabs "render-pdf-to-html">}} {{< tab "JavaScript" >}} ```js import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer'; // Path to the file you want to render const filePath = 'sample.pdf'; // Initialize viewer const viewer = new Viewer(filePath); // Render the file to HTML viewer.view(HtmlViewOptions.forEmbeddedResources()); // Exit with a success code process.exit(0); ``` {{< /tab >}} {{< tab "sample.pdf" >}} {{< tab-text >}} `sample.pdf` is the sample file used in this example. Click [here](https://docs.groupdocs.com/viewer/nodejs-java/_sample_files/getting-started/installation/sample.pdf) to download it. {{< /tab-text >}} {{< /tab >}} {{< /tabs >}} 3. **Run the app** by executing the following command in your terminal: ```bash node app.js ``` This minimal example converts a document to HTML format. The output will contain rendered pages in HTML format. ### Troubleshooting installation - node-gyp toolchain not found: install the required build tools for your OS (see System Requirements). - Java not detected: set `JAVA_HOME` and add `/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.