# Install GroupDocs.Viewer for Java This topic describes how to install GroupDocs.Viewer for Java. {{< alert style="info" >}} Starting from [GroupDocs.Viewer for Java 24.4](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-4-release-notes/), the JAR package is signed using a GPG signature. You can find the public key in the [GPG-KEYS.txt](https://releases.groupdocs.com/java/repo/com/groupdocs/GPG-KEYS.txt) file. Learn more about verifying signatures in the [Making and verifying signatures](https://www.gnupg.org/gph/en/manual/x135.html) article. {{< /alert >}} ## Install using Maven All GroupDocs packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/). You can download packages or reference GroupDocs.Viewer for Java API directly in your Maven project using following steps. {{< alert style="tip" >}} [Download](https://docs.groupdocs.com/viewer/java/sample-apps/getting-started/installation/maven-app.zip) a sample Maven application that demonstrates using GroupDocs.Viewer for Java. You can run the application locally with `mvn exec:java` command. {{< /alert >}} ### Add GroupDocs Artifact Repository Add GroupDocs Artifact Repository to your `pom.xml` file: {{< tabs "pom-repository">}} {{< tab "pom.xml" >}} ```xml GroupDocs Artifact Repository GroupDocs Artifact Repository https://releases.groupdocs.com/java/repo/ ``` {{< /tab >}} {{< /tabs >}} ### Add GroupDocs.Viewer as a dependency Define GroupDocs.Viewer for Java API dependency in your `pom.xml`: {{< tabs "pom-dependency">}} {{< tab "pom.xml" >}} ```xml com.groupdocs groupdocs-viewer 26.9 ``` {{< /tab >}} {{< /tabs >}} ## Reference in Java application To get started, download the latest version of GroupDocs.Viewer for Java (JAR file) from [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/). Also, make sure you have [Java](https://www.oracle.com/java/technologies/downloads/) installed. ### Create application {{< alert style="tip" >}} You can [download](https://docs.groupdocs.com/viewer/java/sample-apps/getting-started/installation/java-app.zip) the sample application and proceed to building it. {{< /alert >}} {{< tabs "java-app">}} {{< tab "App.java" >}} ```java import com.groupdocs.viewer.Viewer; import com.groupdocs.viewer.options.*; public class App { public static void main(String[] args) throws Exception { Viewer viewer = new Viewer("formatting.docx"); viewer.view(HtmlViewOptions.forEmbeddedResources()); viewer.close(); } } ``` {{< /tab >}} {{< tab "formatting.docx" >}} {{< tab-text >}} `formatting.docx` is sample DOCX file that we're going to use in this example. Click [here](https://docs.groupdocs.com/viewer/java/sample-files/getting-started/installation/formatting.docx) to download it. {{< /tab-text >}} {{< /tab >}} {{< tab "groupdocs-viewer.jar" >}} {{< tab-text >}} `groupdocs-viewer.jar` is GroupDocs.Viewer for Java JAR file e.g., [groupdocs-viewer-24.4.jar](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/24.4/groupdocs-viewer-24.4.jar). {{< /tab-text >}} {{< /tab >}} {{< /tabs >}} Your folder tree should look similar to the following directory structure: ```Directory 📂 java-app ├──App.java ├──formatting.docx └──groupdocs-viewer.jar ``` ### Build application To build Java application run the command below. This comand compiles the application and creates `App.class` file in the current directory. {{< tabs "java-app-build">}} {{< tab "Windows" >}} ```bash javac -d . -cp ".;./groupdocs-viewer.jar" App.java ``` {{< /tab >}} {{< tab "Linux" >}} ```bash javac -d . -cp ".:./groupdocs-viewer.jar" App.java ``` {{< /tab >}} {{< /tabs >}} ### Run application To run the application type the command below. As a result two HTML documents will be created in the current directory for the first two pages of the document. {{< tabs "java-app-run">}} {{< tab "Windows" >}} ```bash java -cp ".;./groupdocs-viewer.jar" App ``` {{< /tab >}} {{< tab "Linux" >}} ```bash java -Djava.awt.headless=true -cp ".:./groupdocs-viewer.jar" App ``` {{< tab-text >}} Please note that `-Djava.awt.headless=true` required when your Java installation does not inlude GUI libraries. {{< /tab-text >}} {{< /tab >}} {{< /tabs >}}