Running in Docker Leave feedback

Limitations

Linux containers are recommended and fully supported.
Ensure adequate fonts are installed in the container for accurate text layout.
For Metered licensing, outbound internet access is required to report consumption. File-license mode works fully offline.

Dependencies

We are going to build the Docker image in two stages to minimize the final image size. In the first stage we build the application, and in the second stage we run it.

The key dependencies for the build stage are Node.js, JDK (Java Development Kit), and build tools. The final runtime stage requires only Node.js and JRE (Java Runtime).

Basic Example

This is a practical example showing how to convert a document in a Docker container using the sample code. The final Docker image can be run as an application by passing the source file, output file name, output format, and an optional license file. See the Temporary License page for more details.

Note
You can download this sample application from here.

Project Structure

📂 basic-example/
├── 📂 work/                           
│   ├── 📄 source.docx                  # Input document to convert
│   └── 📄 GroupDocs.Conversion.lic     # The license file (optional)
├── 📄 .dockerignore                    # Files to exclude from Docker build context
├── 📄 Dockerfile                       # Docker container definition
├── 📄 package.json                     # Node.js project file
├── 📄 convert-file.js                  # Main application code
└── 📄 README.md                        # App readme

Let’s look at the most essential parts of the application:

convert-file.js

'use strict';

// Import required modules
const groupdocs = require('@groupdocs/groupdocs.conversion');
const path = require('path')

// Get the source, output, and license paths from the command line arguments
const [sourcePath, outputPath, licensePath] = process.argv.slice(2);

// Get the license path from the command line arguments
if (licensePath) {
  const license = new groupdocs.License()
  license.setLicense(path.join(__dirname, licensePath));
}

// Create a new converter instance and load the source file
const converter = new groupdocs.Converter(sourcePath);

// Set the convert options for PDF format
const options = new groupdocs.PdfConvertOptions();

// Convert the file and save to the output path
converter.convert(outputPath, options);

// Exit the process
process.exit(0);

package.json

{
  "name": "GroupDocs.Conversion for Node.js via Java Example",
  "version": "1.0.0",
  "private": true,
  "main": "convert-file.js",
  "license": "MIT",
  "scripts": {
    "start": "node convert-file.js",
    "dev": "node convert-file.js"
  },
  "engines": {
    "node": ">=20"
  },
  "dependencies": {
    "@groupdocs/groupdocs.conversion": "^25.11.0"
  }
}

Dockerfile

# Build stage – compiles native module and installs dependencies
FROM node:20-bullseye AS build
RUN apt-get update && apt-get install -y \
    openjdk-17-jdk-headless \
    build-essential

# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm install --omit=dev

# Copy the rest of the app
COPY . .

# Final stage – slim runtime image
FROM node:20-bullseye-slim AS final

# Install Java runtime
RUN apt-get update && apt-get install -y \
    openjdk-17-jre-headless  
    
# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy built application and node_modules from the build stage
COPY --from=build /app .

# Set the entry point and default command
ENTRYPOINT ["node", "/app/convert-file.js"]
CMD ["--help"]

Input file

Sample input file source.docx to convert.

Building the Docker Image

To create the Docker image, run the following command in the directory containing the Dockerfile:

docker build -t groupdocs-conversion-sample:latest .

Running the Application

In this example we mount the work directory and use it both to pass source files into the container and to store the conversion result.

If you do not have a license file, you can use the following command that omits the last parameter. GroupDocs.Conversion will work in trial mode.

docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-conversion-sample:latest source.docx converted.pdf

You can add a license parameter if you have a trial or full license file:

docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-conversion-sample:latest source.docx converted.pdf GroupDocs.Conversion.lic

Command Explanation

--rm: Automatically removes the container when it exits
-v: Mounts the host directory to the container directory for file output
-w: Sets the working directory inside container

App Output

The app converts a DOCX file to PDF and outputs converted.pdf in the work folder. The output file contains the converted document in PDF format.

Troubleshooting

Font Issues

If you encounter missing glyphs or layout differences, install additional fonts:

RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core && rm -rf /var/lib/apt/lists/*

node-gyp Build Errors

Ensure build-essential and python3 are installed.
Rebuild if needed: npm rebuild.

Java Not Found

Confirm OpenJDK is installed and JAVA_HOME/PATH are set in the image.

Permissions or Volume Mounts

Verify the mounted directories exist and are writable by the container user.

For general setup details, see System Requirements and Installation.

We value your opinion. Your feedback will help us improve our documentation.