Discovery API Icon
Discovery API
Security Advisory Icon
Security Advisory
Liberica JDK8u302+8Release Information
Installation Guide
Download this page as PDF

Microsoft Windows

Installing with Microsoft Windows Installer package

Open the Download: Liberica JDK in your browser. Click the link “Download MSI” corresponding to your version of Microsoft Windows. After download is finished, verify the file by comparing its size on your drive and on the downloads page. A more advanced approach is to verify the checksum in PowerShell:

(Get-FileHash .\bellsoft-jdk8u302+8-windows-amd64.msi -Algorithm SHA1).Hash

The checksum should match the one which can be found under the link on the downloads page.

In order to run the installer double click on the file you downloaded, this will open the Liberica JDK Setup Wizard.

Figure 1. Welcome

Press ‘Next’ on the welcome screen.

Figure 2. Features

Choose features you need and press ‘Next’. Select a feature to see the description. If in doubt, skip this step and press ‘Next’.

Figure 3. Install

The package is ready to install, press ‘Install’.

  • Please note that the installer screens above may vary for different releases.

If you want to install Liberica JDK silently, open the command line and run the following command:

msiexec /quiet /i bellsoft-jdk8u302+8-windows-amd64.msi

Installing standalone package on Microsoft Windows

To install Liberica JDK download the .zip package and unpack it.

If you do not want to or cannot do it via GUI, then you can use PowerShell:

(New-Object System.Net.WebClient).DownloadFile("https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-windows-amd64.zip", "liberica.zip")
Expand-Archive liberica.zip -DestinationPath .

This will unpack Liberica JDK, including JavaFX to the current directory. Either add bin subdirectory to $PATH, or remember this directory as $LIBERICA_DIR environment variable and run Liberica JDK as

$LIBERICA_DIR/bin/java -jar $your_app

To uninstall Liberica JDK, simply remove this directory and unset related environmental variables.

Apple MacOS

Installing on Apple MacOS

Open the Download: Liberica JDK in your browser. Click the link “Download DMG”. After it is finished, verify the file by comparing its size on your drive and on the downloads page. A more advanced approach is to verify the checksum in the command line:

shasum -a 1 bellsoft-jdk8u302+8-macos-amd64.dmg

The checksum should match the one which can be found under the link on the downloads page.

In order to run the installer double-click on the file you downloaded.

Figure 4. DMG content

Double-click on pkg icon to open the Install Liberica JDK Wizard.

Figure 5. Welcome screen

Click Continue.

Figure 6. Installation Type screen

Optionally, you can change the install location. Click Change Install Location button for that. Or, click Install to proceed with the default location.

Figure 7. Choose Install Location screen

If you’ve chosen to change the install location, select the destination drive and click Continue.

Figure 8. Security Warning screen

Approve new software installation. The file copying starts immediately.

Figure 9. Install in Progress screen

Observe the installation progress.

Figure 10. Installation Success screen

Click Close to dismiss the installation wizard.

How to uninstall Liberica

To uninstall Liberica JRE run the following commands in the terminal:

sudo pkgutil --volume / --forget com.bell-sw.liberica.jre.1.8.0_302
sudo rm -rf /Library/Java/JavaVirtualMachines/liberica-jre-1.8.0_302

To uninstall Liberica JDK:

sudo pkgutil --volume / --forget com.bell-sw.liberica.jdk.1.8.0_302
sudo rm -rf /Library/Java/JavaVirtualMachines/liberica-jdk-1.8.0_302

The both snippets assume that you have installed Liberica on the default, boot volume (/).

Installing standalone package on MacOS

To install Liberica JDK download the .zip package and unpack it.

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-macos-amd64.zip
unzip bellsoft-jdk8u302+8-macos-amd64.zip

This will unpack Liberica JDK, including JavaFX to the current directory. Either add bin subdirectory to $PATH, or remember this directory as $LIBERICA_DIR environment variable and run Liberica JDK as

$LIBERICA_DIR/bin/java -jar $your_app

To uninstall Liberica JDK, simply remove this directory and unset related environmental variables.

Linux

APT Repository (.deb-based Linux distributions)

Add BellSoft official GPG key and setup the repository

wget -q -O - https://download.bell-sw.com/pki/GPG-KEY-bellsoft | sudo apt-key add -
echo "deb [arch=amd64] https://apt.bell-sw.com/ stable main" | sudo tee /etc/apt/sources.list.d/bellsoft.list

Liberica JDK repositories contain all Linux architectures supported in the release: amd64, i386, arm64, armhf. If amd64 is not the target architecture, replace it in the command above with the architecture of choice.

Update repositories and install packages

sudo apt-get update
sudo apt-get install bellsoft-java8

The following packages are available:

  • bellsoft-java8 contains the optimal build for most desktops/servers.

  • bellsoft-java8-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.

  • bellsoft-java8-runtime includes Liberica JRE with JavaFX.

YUM Repository (.rpm-based Linux Distributions)

Set up the repository

echo | sudo tee /etc/yum.repos.d/bellsoft.repo > /dev/null << EOF
[BellSoft]
name=BellSoft Repository
baseurl=https://yum.bell-sw.com
enabled=1
gpgcheck=1
gpgkey=https://download.bell-sw.com/pki/GPG-KEY-bellsoft
priority=1
EOF

Liberica JDK repositories contain all Linux architectures supported in the release.

Update repositories and install packages

sudo yum update
sudo yum install bellsoft-java8

The following packages are available:

  • bellsoft-java8 contains the optimal build for most desktops/servers.

  • bellsoft-java8-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.

  • bellsoft-java8-runtime includes Liberica JRE only.

YaST/Zypper Repository (SUSE Linux)

Set up the repository

echo | sudo tee /etc/zypp/repos.d/repo-bellsoft.repo > /dev/null << EOF
[BellSoft]
name=BellSoft Repository
baseurl=https://yum.bell-sw.com
enabled=1
gpgcheck=1
gpgkey=https://download.bell-sw.com/pki/GPG-KEY-bellsoft
priority=1
EOF

Update repositories and install packages

sudo zypper up
sudo zypper in bellsoft-java8

The following packages are available:

  • bellsoft-java8 contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.

  • bellsoft-java8-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.

  • bellsoft-java8-runtime includes Liberica JRE with JavaFX.

Alpine Linux Repository

Setup the repository

echo "https://apk.bell-sw.com/main" | sudo tee -a /etc/apk/repositories
sudo wget -P /etc/apk/keys/ https://apk.bell-sw.com/[email protected]

Install packages

apk add bellsoft-java11

The following packages are available:

  • bellsoft-java8 contains the optimal build for most desktops/servers.

  • bellsoft-java8-runtime includes Liberica JRE only.

Installing on Alpine Linux manually

Download the following package

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-linux-x64-musl.apk

Or choose one from the downloads page that suits your needs.

Install this package with the following command

apk add --allow-untrusted bellsoft-jdk8u302+8-linux-x64-musl.apk

Off-screen rendering

Containerized deployments sometimes do some off-screen rendering, such as when preparing documents, forms, and images. When performing off-screen rendering, the JDK requires OS fonts and fontconfig libraries to be present. In case when you don’t have these libraries or fonts you will encounter the exception, similar to one below:

    Exception in thread "main" java.lang.InternalError: java.lang.reflect.InvocationTargetException
    at java.desktop/sun.font.FontManagerFactory$1.run(FontManagerFactory.java:86)
    at java.base/java.security.AccessController.doPrivileged(AccessController.java:312)
    at java.desktop/sun.font.FontManagerFactory.getInstance(FontManagerFactory.java:74)
    at java.desktop/sun.font.SunFontManager.getInstance(SunFontManager.java:247)
    at java.desktop/sun.font.FontDesignMetrics.getMetrics(FontDesignMetrics.java:261)
    at java.desktop/sun.swing.SwingUtilities2.getFontMetrics(SwingUtilities2.java:1243)
...
    at jdk.compiler/com.sun.tools.javac.launcher.Main.run(Main.java:192)
    at jdk.compiler/com.sun.tools.javac.launcher.Main.main(Main.java:132)
Caused by: java.lang.NullPointerException
    at java.desktop/sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1262)
    at java.desktop/sun.awt.FontConfiguration.readFontConfigFile(FontConfiguration.java:225)
    at java.desktop/sun.awt.FontConfiguration.init(FontConfiguration.java:107)
    at java.desktop/sun.awt.X11FontManager.createFontConfiguration(X11FontManager.java:719)
    at java.desktop/sun.font.SunFontManager$2.run(SunFontManager.java:362)
    at java.base/java.security.AccessController.doPrivileged(AccessController.java:312)
    at java.desktop/sun.font.SunFontManager.<init>(SunFontManager.java:307)
    at java.desktop/sun.awt.FcFontManager.<init>(FcFontManager.java:35)
    at java.desktop/sun.awt.X11FontManager.<init>(X11FontManager.java:56)
    ... 28 more

On Alpine Linux, these libraries are provided by fontconfig and ttf-dejavu packages, and can be installed by running the following command:

apk add fontconfig ttf-dejavu

Installing using manual RPM installation

Obtain BellSoft official GPG key and then import it

wget -q -O - https://download.bell-sw.com/pki/GPG-KEY-bellsoft
sudo rpm --import GPG-KEY-bellsoft

Download a package and install it

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-linux-amd64.rpm
sudo rpm --install bellsoft-jdk8u302+8-linux-amd64.rpm

Installing on Ubuntu and other DEB-based OSes

To install Liberica JDK download the .deb package and run apt tool:

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-linux-amd64.deb
sudo apt install ./bellsoft-jdk8u302+8-linux-amd64.deb

This will install bellsoft-java8 JDK package, including JavaFX.

To use Liberica JRE, simply run

java -jar $your_app

This will automatically pick JavaFX or DeviceIO dependencies when compiled into the JDK.

To uninstall Liberica JDK, run the following command:

sudo apt remove bellsoft-java8

Installing on Red Hat Linux and other RPM-based OSes

To install Liberica JDK download the .rpm package and run apt tool:

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-linux-amd64.rpm
sudo yum install ./bellsoft-jdk8u302+8-linux-amd64.rpm

This will install bellsoft-java8 JDK package, including JavaFX.

To use Liberica JRE, simply run

java -jar $your_app

This will automatically pick JavaFX or DeviceIO dependencies when compiled into the JDK.

To uninstall Liberica JDK, run the following command:

sudo yum remove bellsoft-java8

Installing standalone JDK package on GNU/Linux

To install Liberica JDK download the .tag.gz package and unpack it.

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-linux-amd64.tar.gz
tar -zxvf bellsoft-jdk8u302+8-linux-amd64.tar.gz

This will unpack Liberica JDK, including JavaFX to the current directory. Either add bin subdirectory to $PATH, or remember this directory as $LIBERICA_DIR environment variable and run Liberica JDK as

$LIBERICA_DIR/bin/java -jar $your_app

To uninstall Liberica JDK, simply remove this directory and unset related environmental variables.

Solaris

Installing standalone package on Solaris

To install Liberica JDK download the .tag.gz package and unpack it.

wget https://download.bell-sw.com/java/8u302+8/bellsoft-jdk8u302+8-solaris-x64.tar.gz
tar -zxvf bellsoft-jdk8u302+8-solaris-x64.tar.gz

This will unpack Liberica JDK, including JavaFX to the current directory. Either add bin subdirectory to $PATH, or remember this directory as $LIBERICA_DIR environment variable and run Liberica JDK as

$LIBERICA_DIR/bin/java -jar $your_app

To uninstall Liberica JDK, simply remove this directory and unset related environmental variables.

ON THIS PAGE