# Installation
Installation guide for GroupDocs.Parser for Java. Learn how to add the library to Maven or Gradle projects from the GroupDocs repository, install it from a downloaded package, and prepare a Linux environment.
## Prerequisites
### Java requirements
GroupDocs.Parser for Java requires **Java 8 (1.8) or later** (JDK to build your application, JRE or JDK to run it). See [System Requirements]({{< ref "parser/java/getting-started/system-requirements.md" >}}) for the full list of supported operating systems and development environments.
| Item | Value |
|------|-------|
| Group ID | `com.groupdocs` |
| Artifact ID | `groupdocs-parser` |
| Current version | `26.10` |
| Repository | `https://releases.groupdocs.com/java/repo/` |
{{< alert style="info" >}}
The `groupdocs-parser` JAR is self-contained: its POM declares no transitive dependencies, so you add only the one artifact. A JDBC driver is needed only if you [extract data from databases]({{< ref "parser/java/developer-guide/advanced-usage/extract-data-from-databases.md" >}}), and an OCR library only if you plug in an [OCR connector]({{< ref "parser/java/developer-guide/advanced-usage/using-ocr/_index.md" >}}).
{{< /alert >}}
## Install from GroupDocs Repository using Maven
GroupDocs hosts all Java APIs on [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Parser for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-parser/) API directly in your Maven projects with simple configurations.
### Specify GroupDocs Repository Configuration
First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows:
```xml
GroupDocsJavaAPI
GroupDocs Java API
https://releases.groupdocs.com/java/repo/
```
### Define GroupDocs.Parser for Java API Dependency
Then define GroupDocs.Parser for Java API dependency in your `pom.xml` as follows:
```xml
com.groupdocs
groupdocs-parser
26.10
```
After performing above-mentioned steps, GroupDocs.Parser for Java dependency will finally be added to your Maven project. Run `mvn compile` (or reload the Maven project in your IDE) to download it.
## Install using Gradle
Add the GroupDocs repository and the dependency to your `build.gradle`:
```groovy
repositories {
mavenCentral()
maven {
url "https://releases.groupdocs.com/java/repo/"
}
}
dependencies {
implementation "com.groupdocs:groupdocs-parser:26.10"
}
```
For the Kotlin DSL (`build.gradle.kts`):
```kotlin
repositories {
mavenCentral()
maven("https://releases.groupdocs.com/java/repo/")
}
dependencies {
implementation("com.groupdocs:groupdocs-parser:26.10")
}
```
## Quick start with Maven
Here's a complete example of setting up a new console project:
```bash
# 1. Create a new project
mvn archetype:generate -DgroupId=com.example -DartifactId=parser-demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
cd parser-demo
# 2. Add the GroupDocs repository and the groupdocs-parser dependency to pom.xml (see above),
# and set the compiler level to Java 8 or later
# 3. Build and run the project
mvn compile exec:java -Dexec.mainClass=com.example.App
```
Then update `src/main/java/com/example/App.java`:
```java
package com.example;
import com.groupdocs.parser.Parser;
import com.groupdocs.parser.data.TextReader;
import java.io.IOException;
public class App {
public static void main(String[] args) throws IOException {
// Create an instance of Parser class
try (Parser parser = new Parser("sample.pdf")) {
// Extract a text to the reader
try (TextReader reader = parser.getText()) {
// Print an extracted text (or "not supported" message)
System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
}
}
}
}
```
## Install from official GroupDocs website
You can follow the steps below to reference GroupDocs.Parser for Java downloaded from official website [Downloads section](https://releases.groupdocs.com/parser/java/):
1. Unpack zip archive.
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the GroupDocs.Parser for Java **dependency** block to your `pom.xml` project file.
If you don't use Maven or Gradle, add the `groupdocs-parser-26.10.jar` file to the classpath of your application (for example, in IntelliJ IDEA: **File** -> **Project Structure** -> **Modules** -> **Dependencies** -> **+** -> **JARs or directories**).
## Linux environment
GroupDocs.Parser for Java is pure Java: unlike the .NET version, it doesn't need native packages such as `libgdiplus` on Linux.
Text layout operations — page previews, text areas, formatted text and table detection in Word processing documents and presentations — use the fonts installed on the machine. Minimal Linux images often contain no fonts at all, which can change the measured positions of text. Install a set of TrueType fonts, for example the Microsoft compatible fonts:
```bash
sudo apt-get install ttf-mscorefonts-installer
```
## More resources
* [System Requirements]({{< ref "parser/java/getting-started/system-requirements.md" >}})
* [How to Run Examples]({{< ref "parser/java/getting-started/how-to-run-examples.md" >}})
* [Evaluation Limitations and Licensing]({{< ref "parser/java/getting-started/evaluation-limitations-and-licensing.md" >}})
* [GroupDocs.Parser for Java Maven Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-parser/)
* [GroupDocs.Parser for Java examples on GitHub](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)