Microsoft Windows
Installing with Microsoft Windows Installer package
Open the Download: Liberica JDK in your browser. Find a distribution variant that is more suitable for your needs and 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-jdk11.0.12+7-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.
Press ‘Next’ on the welcome screen.
Choose features you need and press ‘Next’. Select a feature to see the description. If in doubt, skip this step and press ‘Next’.
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-jdk11.0.12+7-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/11.0.12+7/bellsoft-jdk11.0.12+7-windows-amd64.zip", "liberica.zip")
Expand-Archive liberica.zip -DestinationPath .
This will unpack Liberica JDK 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. Find a distribution variant that is more suitable for your needs and 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-jdk11.0.12+7-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.
Double-click on pkg icon to open the Install Liberica JDK Wizard.
Click Continue.
Optionally, you can change the install location. Click Change Install Location button for that. Or, click Install to proceed with the default location.
If you’ve chosen to change the install location, select the destination drive and click Continue.
Approve new software installation. The file copying starts immediately.
Observe the installation progress.
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.11.0.12
sudo rm -rf /Library/Java/JavaVirtualMachines/liberica-jre-11.0.12
To uninstall Liberica JDK:
sudo pkgutil --volume / --forget com.bell-sw.liberica.jdk.11.0.12
sudo rm -rf /Library/Java/JavaVirtualMachines/liberica-jdk-11.0.12
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/11.0.12+7/bellsoft-jdk11.0.12+7-macos-amd64.zip
unzip bellsoft-jdk11.0.12+7-macos-amd64.zip
This will unpack Liberica JDK 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-java11
The following packages are available:
-
bellsoft-java11 contains the optimal build for most desktops/servers.
-
bellsoft-java11-lite includes Liberica JDK with compressed modules and Server VM, without any extra packages.
-
bellsoft-java11-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.
-
bellsoft-java11-runtime includes Liberica JRE only.
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-java11
The following packages are available:
-
bellsoft-java11 contains the optimal build for most desktops/servers.
-
bellsoft-java11-lite includes Liberica JDK with compressed modules and Server VM, without any extra packages.
-
bellsoft-java11-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.
-
bellsoft-java11-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-java11
The following packages are available:
-
bellsoft-java11 contains the optimal build for most desktops/servers.
-
bellsoft-java11-lite includes Liberica JDK with compressed modules and Server VM, without any extra packages.
-
bellsoft-java11-full contains the full Liberica JDK, including JavaFX and a variety of JVMs for platforms which support it.
-
bellsoft-java11-runtime includes Liberica JRE only.
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-java11 contains the optimal build for most desktops/servers.
-
bellsoft-java11-lite includes Liberica JDK with compressed modules and Server VM, without any extra packages.
-
bellsoft-java11-runtime includes Liberica JRE only.
Installing on Alpine Linux manually
Download the following package
wget https://download.bell-sw.com/java/11.0.12+7/bellsoft-jdk11.0.12+7-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-jdk11.0.12+7-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/11.0.12+7/bellsoft-jdk11.0.12+7-linux-amd64.rpm
sudo rpm --install bellsoft-jdk11.0.12+7-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/11.0.12+7/bellsoft-jdk11.0.12+7-linux-amd64.deb
sudo apt install ./bellsoft-jdk11.0.12+7-linux-amd64.deb
This will install bellsoft-java11 JDK package.
To use Liberica JRE, simply run
java -jar $your_app
To uninstall Liberica JDK, run the following command:
sudo apt remove bellsoft-java11
Installing on Red Hat Linux and other RPM-based OSes
To install Liberica JDK download the .rpm package and run rpm tool:
wget https://download.bell-sw.com/java/11.0.12+7/bellsoft-jdk11.0.12+7-linux-amd64.rpm
sudo yum install ./bellsoft-jdk11.0.12+7-linux-amd64.rpm
To use Liberica JRE, simply run
java -jar $your_app
To uninstall Liberica JDK, run the following command:
sudo yum remove bellsoft-java11
Installing on Alpine Linux
To install Liberica JDK download the .apk package and run apk tool:
wget https://download.bell-sw.com/java/11.0.12+7/bellsoft-jdk11.0.12+7-linux-x64-musl.apk
sudo apk add --allow-untrusted ./bellsoft-jdk11.0.12+7-linux-x64-musl.apk
To uninstall Liberica JDK, run the following command:
sudo apk del bellsoft-java11
Installing standalone JDK package on GNU/Linux
To install Liberica JDK download the .tar.gz package and unpack it.
wget https://download.bell-sw.com/java/11.0.12+7/bellsoft-jdk11.0.12+7-linux-amd64.tar.gz
tar -zxvf bellsoft-jdk11.0.12+7-linux-amd64.tar.gz
This will unpack Liberica JDK 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 .tar.gz package and unpack it.
wget https://download.bell-sw.com/java/11.0.12+7/bellsoft-jdk11.0.12+7-solaris-x64.tar.gz
tar -zxvf bellsoft-jdk11.0.12+7-solaris-x64.tar.gz
This will unpack Liberica JDK 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.
Liberica Distribution Variants
There are 3 distribution variants:
-
Regular — can be used to run, compile and debug applications or create your own Java Runtime with a subset of Java modules;
-
Full — includes LibericaFX and Minimal VM, where suitable;
-
Lite — if you’re looking for smaller footprint, yet fully functional JDK.