diff --git a/en/Installation.md b/en/Installation.md
index 234c022..0bf47fa 100644
--- a/en/Installation.md
+++ b/en/Installation.md
@@ -3,6 +3,7 @@ title: Installation
helpCategories:
- General
---
+
# Installation
This page describes how to install Java, which is required for JabRef.
@@ -15,31 +16,39 @@ You can also install it manually as described here.
The installation steps are written having the [JavaFX development branch](https://builds.jabref.org/javafx/) in mind.
Thus, it especially describes installing [JavaFX].
-## Table of Contents
-
-
-
- [Supported JDKs and JREs](#supported-jdks-and-jres)
+ - [JabRef 5.x](#jabref-5x)
+ - [JabRef 4.x](#jabref-4x)
- [Verify Java Installation](#verify-java-installation)
- [Installation Commands](#installation-commands)
- * [Ubuntu and Oracle Java](#ubuntu-and-oracle-java)
- * [Ubuntu 16.04 and OpenJDK](#ubuntu-1604-and-openjdk)
- * [Debian Jessie 8 and Oracle Java](#debian-jessie-8-and-oracle-java)
- + [Using the ppa](#using-the-ppa)
- + [Directly from Oracle](#directly-from-oracle)
- * [Fedora 23 and Oracle Java](#fedora-23-and-oracle-java)
- * [Fedora and OpenJDK](#fedora-and-openjdk)
- * [CentOS 6 or 7 and Oracle Java](#centos-6-or-7-and-oracle-java)
- * [openSUSE](#opensuse)
- * [Arch and Manjaro](#arch-and-manjaro)
- * [Windows and Oracle Java](#windows-and-oracle-java)
- * [Mac OS and Oracle Java](#mac-os-and-oracle-java)
+ - [JabRef 5.x](#jabref-5x-1)
+ - [Ubuntu](#ubuntu)
+ - [JabRef 4.x](#jabref-4x-1)
+ - [Ubuntu and Oracle Java](#ubuntu-and-oracle-java)
+ - [Ubuntu and OpenJDK](#ubuntu-and-openjdk)
+ - [Debian Jessie 8 and Oracle Java](#debian-jessie-8-and-oracle-java)
+ - [Using the ppa](#using-the-ppa)
+ - [Directly from Oracle](#directly-from-oracle)
+ - [Fedora 23 and Oracle Java](#fedora-23-and-oracle-java)
+ - [Fedora and OpenJDK](#fedora-and-openjdk)
+ - [CentOS 6 or 7 and Oracle Java](#centos-6-or-7-and-oracle-java)
+ - [openSUSE](#opensuse)
+ - [Arch and Manjaro](#arch-and-manjaro)
+ - [Windows and Oracle Java](#windows-and-oracle-java)
+ - [Mac OS and Oracle Java](#mac-os-and-oracle-java)
+- [Freezes when running JabRef](#freezes-when-running-jabref)
- [JabRef and OpenOffice/LibreOffice integration](#jabref-and-openofficelibreoffice-integration)
-
-
## Supported JDKs and JREs
+### JabRef 5.x
+
+> JabRef 5.x requires JRE 11
+
+### JabRef 4.x
+
+> JabRef 4.x requires JRE 8 (and does not run at JRE 9 onwoards)
+
JavaFX is not included in every Java runtime environment or development kit.
Therefore, we highly recommend to use [Oracle Java 8](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
JavaFX is included since Java 1.8.0_60.
@@ -49,7 +58,6 @@ Therefore, we only recommend this if you know what you are doing.
In case you want to use OpenJDK with OpenJFX in general you should follow this [instructions](https://wiki.openjdk.java.net/display/OpenJFX/Building+OpenJFX).
For Ubuntu 16.04 LTS and 18.04 LTS head to the section [Installation Commands](#installation-commands).
-
## Verify Java Installation
In case you already have a Java version installed - or you closely followed the steps below, you can check your Java version by typing the following command into your command line interface:
@@ -68,34 +76,31 @@ Your Java version should look like this, depending on your operating system and
**Oracle Java 32-Bit:**
```
-Java version "1.8.0_x"
+Java version "1.8.0_x"
Java(TM) SE Runtime Environment (build 1.8.x)
Java HotSpot(TM) Client VM (build 25.x, mixed mode)
```
-
**Oracle Java 64-Bit:**
```
-Java version "1.8.0_x"
+Java version "1.8.0_x"
Java(TM) SE Runtime Environment (build 1.8.x)
Java HotSpot(TM) 64-Bit Server VM (build 25.x, mixed mode)
```
-
**OpenJDK 32-Bit:**
```
-OpenJDK version "1.8.0_x"
+OpenJDK version "1.8.0_x"
OpenJDK Runtime Environment (build 1.8.0_x)
OpenJDK Client VM (build 25.x, mixed mode)
```
-
**OpenJDK 64-Bit:**
```
-OpenJDK version "1.8.0_x"
+OpenJDK version "1.8.0_x"
OpenJDK Runtime Environment (build 1.8.0_x)
OpenJDK 64-Bit Server VM (build 25.x, mixed mode)
```
@@ -103,10 +108,20 @@ OpenJDK 64-Bit Server VM (build 25.x, mixed mode)
If this does not report to be a product from Oracle (for instance tells you that it is a GCJ VM) even if you have installed the Oracle JVM then you need to change your setup.
In the following, the installation is documented for Ubuntu, Debian, Fedora, CentOS, Windows, and MacOSX.
-
## Installation Commands
-### Ubuntu and Oracle Java
+### JabRef 5.x
+
+#### Ubuntu
+
+1. Follow the steps at https://bell-sw.com/pages/liberica_install_guide-11.0.4/#apt-repository-deb-based-linux-distributions
+2. Ensure that gtk3 is available: `sudo apt-get install gtkterm`
+
+Now, you should be able to execute `java -jar JabRef--master--latest.jar`
+
+### JabRef 4.x
+
+#### Ubuntu and Oracle Java
This applies for both 32bit and 64bit and both Ubuntu 14.04 LTS, 16.04 LTS and 18.04 LTS.
@@ -118,21 +133,21 @@ Install Oracle JDK with "personal packages archiv (ppa)" which includes an autom
If you want to install JRE or install java without ppa you should follow these [instructions](https://help.ubuntu.com/community/Java).
-### Ubuntu and OpenJDK
+#### Ubuntu and OpenJDK
Just install JavaFX by executing `sudo apt-get install openjfx`.
For Ubuntu 18.04 and newer, `openjfx` [uses the Java version 11](https://github.com/JabRef/help.jabref.org/issues/204) which is currently not supported by JabRef. Hence, use an older version:
-1) If you accidently installed the new version, remove it with `sudo apt purge openjfx`.
-2) Install an older version with `sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2`.
-3) To prevent the software updater from installing the newer not supported version, mark it to be not updated with `sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java`.
-This also works for Linux Mint 19.1 Tessa which is based on Ubuntu 18.04.
+1. If you accidently installed the new version, remove it with `sudo apt purge openjfx`.
+2. Install an older version with `sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2`.
+3. To prevent the software updater from installing the newer not supported version, mark it to be not updated with `sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java`.
+This also works for Linux Mint 19.1 Tessa which is based on Ubuntu 18.04.
-### Debian Jessie 8 and Oracle Java
+#### Debian Jessie 8 and Oracle Java
-#### Using the ppa
+##### Using the ppa
1. Add repository: `sudo sh -c 'echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" >> /etc/apt/sources.list'`
2. Add GPG key: `sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EEA14886`
@@ -141,7 +156,7 @@ This also works for Linux Mint 19.1 Tessa which is based on Ubuntu 18.04.
Based on:
-#### Directly from Oracle
+##### Directly from Oracle
1. Download tag.gz-file from the [Java SE Development Kit 8 Downloads] site
2. Navigate to the folder where you downloaded the tar.gz-file
@@ -149,8 +164,7 @@ Based on:
4. Get root access with `su`
5. Install with `dpkg -i oracle-java8-jdk_[Version].deb`
-
-### Fedora 23 and Oracle Java
+#### Fedora 23 and Oracle Java
1. Download rpm-file from the [Java SE Development Kit 8 Downloads] site
2. Navigate to the folder where you downloaded the rpm-file
@@ -160,7 +174,7 @@ Based on:
Recent JabRef builds are available at .
-### Fedora and OpenJDK
+#### Fedora and OpenJDK
1. Install OpenJDK: `sudo dnf install java-1.8.0-openjdk`
2. Install JavaFX (actually OpenJFX): `sudo dnf install openjfx java-1.8.0-openjdk-openjfx`
@@ -171,19 +185,19 @@ Recent JabRef builds are available at