System Requirements

Aspose.Words for Java does not require third party product such as Microsoft Word to be installed. Aspose.Words itself is an engine for creating, modifying, converting, and rendering of documents in various formats, including Microsoft Word document formats.

Supported Operating Systems

Any Operating System that can run the Java Runtime Environment (JRE) can run Aspose.Words for Java. The following table lists most, but not all, supported Operating Systems.

Operating System Versions
Microsoft Windows
  • Windows 2003 Server (x64, x86)
  • Windows 2008 Server (x64, x86)
  • Windows 2012 Server (x64, x86)
  • Windows 2012 R2 Server (x64, x86)
  • Windows 2016 Server (x64, x86)
  • Windows 2019 Server (x64, x86)
  • Windows XP (x64, x86)
  • Windows Vista (x64, x86)
  • Windows 7 (x64, x86)
  • Windows 8, 8.1 (x64, x86)
  • Windows 10 (x64, x86)
Linux
  • Ubuntu
  • OpenSUSE
  • CentOS
  • and others
macOS
  • macOS version 10.9 (Mavericks) and later
Mobile
  • Android
  • iOS

Supported Cloud Platforms

Aspose.Words for Java supports any cloud platforms that can run Java applications.

Supported Java Versions

Aspose.Words for Java supports Java 7 and newer. If you are forced to use Java 6, we still release a separate JAR for Java 6.

Optional Dependencies

As we stated above, Aspose.Words for Java requires only the Java Runtime Environment, and you do not need to install any additional libraries.

However, sometimes there are situations where you might need to add third-party libraries:

  • JogAmp JOGL library for hardware accelerated OpenGL rendering. The library is included in the aspose-words POM file as an external dependency. You can edit the POM file to preserve JOGL jars required for your platform only. Or you can remove the dependency if you do not need hardware accelerated OpenGL rendering.
  • HarfBuzz font engine. It is already included in JRE 9 and newer. If you are using JRE 8 or older, you can use the shaping-harfbuzz-plugin dependency in our POM file. Otherwise, you can remove the dependency.
  • Java Advanced Imaging (JAI) to support TIFF images. TIFF images are not supported by Java 8 and older. For TIFF support in old Java environments, Aspose.Words for Java depends on the Java Advanced Imaging (JAI) package from Oracle. We will describe how to install JAI below.

How to Install JAI on Windows

Follow these steps to install native JAI and ImageIO on Windows:

  1. Download JAI 1.1.3. At the time of writing, only the 32-bit version of the installer is available, so if you use a JDK you need to download Jai-1_1_3-lib-windows-i586-jdk.exe and if you use a JRE you need to download Jai-1_1_3-lib-windows-i586-jre.exe.
  2. Run the installer and point it to the directory where JDK/JRE is installed.
  3. Download JAI Image I/O 1.1. At the time of writing, only the 32-bit version of the installer is available, so if you use a JDK you need to download jai_imageio-1_1-lib-windows-i586-jdk.exe and if you use a JRE you need to download jai_imageio-1_1-lib-windows-i586-jre.exe
  4. Run the installer and point it to the directory where JDK/JRE is installed.

How to Install JAI on Linux

Follow these steps to install native JAI and ImageIO on Linux:

  1. Download JAI 1.1.3 choosing the appropriate architecture:

    1. i586 for 32-bit systems
    2. amd64 for 64-bit ones (even if using Intel processors)
  2. Extract the file into a temporary directory.

  3. Move JAR files to the JDK/JRE lib/ext folder.

  4. Move SO files to the JDK/JRE lib/amd64 folder.

    For example, on a 64-bit Ubuntu system, steps 1-4 will look like this:

       $ cd /tmp
       $ wget https://download.java.net/media/jai/builds/release/1_1_3/jai-1_1_3-lib-linux-amd64.tar.gz && \
       gunzip -c jai-1_1_3-lib-linux-amd64.tar.gz | tar xf - && \
       mv /tmp/jai-1_1_3/lib/*.jar $JAVA_HOME/jre/lib/ext/ && \
       mv /tmp/jai-1_1_3/lib/*.so $JAVA_HOME/jre/lib/amd64/ && \
       rm /tmp/jai-1_1_3-lib-linux-amd64.tar.gz && \
       rm -r /tmp/jai-1_1_3
       
    

  5. Download JAI Image I/O 1.1, choosing the appropriate architecture:

    1. i586 for the 32-bit systems
    2. amd64 for the 64-bit ones (even if using Intel processors)
  6. Extract the file into a temporary directory.

  7. Move JAR files to the JDK/JRE lib/ext folder.

  8. Move SO files to the JDK/JRE lib/amd64 folder.

    For example, on a 64-bit Ubuntu system, steps 5-8 will look like this:

       $ cd /tmp
       $ wget https://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-amd64.tar.gz && \
       gunzip -c jai_imageio-1_1-lib-linux-amd64.tar.gz | tar xf - && \
       mv /tmp/jai_imageio-1_1/lib/*.jar $JAVA_HOME/jre/lib/ext/ && \
       mv /tmp/jai_imageio-1_1/lib/*.so $JAVA_HOME/jre/lib/amd64/ && \
       rm /tmp/jai_imageio-1_1-lib-linux-amd64.tar.gz && \
       rm -r /tmp/jai_imageio-1_1
       
    

Folder for Temporary Files

Aspose.Words for Java uses a temporary directory on your computer, which is specified via java.io.tmpdir system property. Aspose.Words for Java writes temporary files and then removes these files as soon as rendering is completed.

java.io.tmpdir is a standard Java system property that is also used by disk-based storage policies. It determines where the JVM writes temporary files.