Liberica NIK 21.2.0 Install Guide
The following sections constitute a native image installation guide for Liberica NIK. It describes the experience of using native images in correspondence to different operating systems.
Apple macOS
Installing DMG bundle on Apple macOS
Open the Liberica NIK Download Center in your browser. Click ‘Download .DMG’ and start the download. After it is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-macos-amd64.dmg
The checksum should match the one next to the link on the downloads page.
To run the installer, double-click on the file you have just downloaded.
Double-click on the pkg icon to open the Install Liberica NIK Wizard.
Click Continue.
Optionally, you can change the install location. Press ‘Change Install Location’ for that or ‘Install’ to proceed with the default location.
Allow new software installation. The file will start copying immediately.
Press ‘Close’ to dismiss the installation wizard.
Liberica NIK 21.2.0 is installed to the /Library/Java/LibericaNativeImageKit/liberica-vm-21.2.0-openjdk11/ directory. You can use the $NIK_HOME environment variable to remember the path to the installed package: /Library/Java/LibericaNativeImageKit/liberica-vm-21.2.0-openjdk11/Contents/Home/.
Installing ZIP bundle on macOS
To install Liberica NIK, download the .zip package.
curl -O https://download.bell-sw.com/vm/21.2.0/bellsoft-liberica-vm-openjdk11-21.2.0-macos-amd64.zip
After the download is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-macos-amd64.zip
Now unpack it.
unzip bellsoft-liberica-vm-openjdk11-21.2.0-macos-amd64.zip
sudo mv bellsoft-liberica-vm-openjdk11-21.2.0 /Library/Java/LibericaNativeImageKit/
This will unpack Liberica NIK to /Library/Java/LibericaNativeImageKit/. Either add Contents/Home/bin subdirectory to $PATH, or remember /Library/Java/LibericaNativeImageKit/bellsoft-liberica-vm-openjdk11-21.2.0/Contents/Home/ as the $NIK_HOME environment variable.
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables.
Installing language plugins on macOS
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
---------------------------------------------------------------------------------------------------------------------------------
llvm-toolchain 21.2.0 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.2.0 Native Image Early adopter download.bell-sw.com
nodejs 21.2.0 Graal.nodejs Supported download.bell-sw.com
python 21.2.0 Graal.Python Experimental download.bell-sw.com
R 21.2.0 FastR Experimental download.bell-sw.com
ruby 21.2.0 TruffleRuby Experimental download.bell-sw.com
wasm 21.2.0 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install a specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
curl -O https://download.bell-sw.com/vm/21.2.0/python-installable-openjdk11-21.2.0-macos-amd64.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.2.0-macos-amd64.jar
Liberica NIK dependencies on macOS
xcode is required for Liberica Native Image Kit. Install necessary tools with the following command:
xcode-select --install
Linux
Installing DEB and RPM packages
Open the Liberica NIK Download Center in your browser. Click ‘Download .RPM’ or ‘Download .DEB’ and start the download. After it is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.deb
The checksum should match the one next to the link on the downloads page.
Install the package using the appropriate package manager. See our example for Apt:
apt install ./bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.deb
Or for an RPM-base system:
yum install ./bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.rpm
The package is installed to /opt/bellsoft/liberica-vm-21.2.0-openjdk11/.
For scripting purposes, it may be beneficial to add the ${NIK_HOME} environment variable which would point to your Native Image Kit installation directory.
Installing standalone NIK package on GNU/Linux
To install Liberica NIK, download the .tar.gz package.
wget https://download.bell-sw.com/vm/21.2.0/bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.tar.gz
After the download is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.tar.gz
Unpack it with the following command.
export INSTALL_DIR=<your directory>
tar -C $INSTALL_DIR -xzf bellsoft-liberica-vm-openjdk11-21.2.0-linux-amd64.tar.gz
This will unpack Liberica NIK to the selected directory. Either add $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.2.0/bin to $PATH, or remember $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.2.0 as the $NIK_HOME environment variable.
Using Liberica NIK
Run your application as:
$NIK_HOME/bin/java -jar $your_app
and the gu utility as
$NIK_HOME/bin/gu available
Finally, install Native Image with
$NIK_HOME/bin/gu install native-image
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables. This concludes the native image Linux example.
Installing language plugins on Linux
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
---------------------------------------------------------------------------------------------------------------------------------
llvm-toolchain 21.2.0 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.2.0 Native Image Early adopter download.bell-sw.com
nodejs 21.2.0 Graal.nodejs Supported download.bell-sw.com
python 21.2.0 Graal.Python Experimental download.bell-sw.com
R 21.2.0 FastR Experimental download.bell-sw.com
ruby 21.2.0 TruffleRuby Experimental download.bell-sw.com
wasm 21.2.0 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
wget https://download.bell-sw.com/vm/21.2.0/python-installable-openjdk11-21.2.0-linux-amd64.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.2.0-linux-amd64.jar
Liberica NIK dependencies on Linux
Several libraries are required for Liberica Native Image Kit on Linux systems. It is possible to install these libraries on Debian-based systems with the following command:
apt install g++ make zlib1g-dev
Installable components also have dependencies on additional libraries. Truffleruby depends on libssl-dev, and FastR depends on libgfortran4.
You can use a similar command to install dependencies on rpm-based systems. See this example for CentOS:
yum install gcc-c++ make zlib-devel
Other types of Linux systems may require different packages.
Alpine Linux
Installing APK package on Alpine Linux
Open the Liberica NIK Download Center in your browser. Click ‘Download .DMG’ and start the download. After it is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-linux-x64-musl.apk
The checksum should match the one next to the link on the downloads page.
Install the package using the appropriate package manager. See our example for Apt:
# Add public key to check signature
wget -P /etc/apk/keys/ https://apk.bell-sw.com/[email protected]
# Install package
apk add ./bellsoft-liberica-vm-openjdk11-21.2.0-linux-x64-musl.apk
The package is installed to /opt/bellsoft/liberica-vm-21.2.0-openjdk11/.
For scripting purposes, it may be beneficial to add the ${NIK_HOME} environment variable which would point to your Native Image Kit installation directory.
Installing standalone NIK package on Alpine Linux
To install Liberica NIK, download the .tar.gz package.
wget https://download.bell-sw.com/vm/21.2.0/bellsoft-liberica-vm-openjdk11-21.2.0-linux-x64-musl.tar.gz
After the download is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.2.0-linux-x64-musl.tar.gz
Unpack it with the following command.
export INSTALL_DIR=<your directory>
tar -C $INSTALL_DIR -xzf bellsoft-liberica-vm-openjdk11-21.2.0-linux-x64-musl.tar.gz
This will unpack Liberica NIK to the selected directory. Either add $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.2.0/bin to $PATH, or remember $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.2.0 as the $NIK_HOME environment variable and run Liberica NIK as
$NIK_HOME/bin/java -jar $your_app
and the gu utility as
$NIK_HOME/bin/gu available
Finally, install Native Image with
$NIK_HOME/bin/gu install native-image
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables. This concludes the native image Alpine Linux example.
Installing language plugins on Alpine Linux
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
---------------------------------------------------------------------------------------------------------------------------------
llvm-toolchain 21.2.0 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.2.0 Native Image Early adopter download.bell-sw.com
nodejs 21.2.0 Graal.nodejs Supported download.bell-sw.com
python 21.2.0 Graal.Python Experimental download.bell-sw.com
R 21.2.0 FastR Experimental download.bell-sw.com
ruby 21.2.0 TruffleRuby Experimental download.bell-sw.com
wasm 21.2.0 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
wget https://download.bell-sw.com/vm/21.2.0/python-installable-openjdk11-21.2.0-linux-x64-musl.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.2.0-linux-x64-musl.jar
Liberica NIK dependencies on Alpine Linux
Several libraries are required for Liberica Native Image Kit on Alpine Linux. It is possible to install these libraries with the following command:
apk add bash g++ make zlib-static
Installable components also have dependencies on additional libraries. Truffleruby depends on openssl-dev, and FastR depends on libgfortran.
Microsoft Windows
Installing with Microsoft Windows Installer package
Open the Liberica NIK Download Center in your browser. Click ‘Download .MSI’ and start the download. After it is finished, check the file by comparing its size on your drive and the downloads page. A more advanced approach is to verify the checksum in PowerShell:
(Get-FileHash .\bellsoft-liberica-vm-openjdk11-21.2.0-windows-amd64.msi -Algorithm SHA1).Hash
The checksum should match the one next to the link on the downloads page.
To run the installer, double-click on the file you have just downloaded. This will open the Liberica NIK 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 NIK silently, open the command line and run the following command:
msiexec /quiet /i bellsoft-liberica-vm-openjdk11-21.2.0-windows-amd64.msi
Liberica NIK is installed to the C:\Program Files\BellSoft\LibericaNIK-21-OpenJDK-11 directory by default. For scripting purposes, it may be beneficial to add the NIK_HOME environment variable which would point to your Native Image Kit installation directory.
Installing standalone package on Microsoft Windows
To install Liberica NIK, download the .zip package and unpack it.
If you do not want to or cannot do it via GUI, use PowerShell:
(New-Object System.Net.WebClient).DownloadFile("https://download.bell-sw.com/vm/21.2.0/bellsoft-liberica-vm-openjdk11-21.2.0-windows-amd64.zip", "liberica.zip")
Expand-Archive liberica.zip -DestinationPath .
This will unpack Liberica NIK to the current directory. Either add bin subdirectory to PATH, or remember this directory as the NIK_HOME environment variable and run Liberica NIK as
"%NIK_HOME\bin\java.exe" -jar your_app.jar
Installing language plugins on Windows
Open the terminal and type:
"%NIK_HOME%\bin\gu.cmd" available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
---------------------------------------------------------------------------------------------------------------------------------
native-image 21.2.0 Native Image Early adopter download.bell-sw.com
nodejs 21.2.0 Graal.nodejs Supported download.bell-sw.com
wasm 21.2.0 GraalWasm Experimental download.bell-sw.com
Execute "%NIK_HOME%\bin\gu.cmd" install [language] to install a specific language. For example, "%NIK_HOME%\bin\gu.cmd" install nodejs.
Finally, install Native Image with
"%NIK_HOME%\bin\gu.cmd" install native-image
Liberica NIK dependencies on Windows
Microsoft Visual Studio 2017 with Microsoft Visual C++ (MSVC) 15 or later is required for Liberica Native Image Kit.
Start x64 Native Tools Command Prompt to allow native-image and other utilities to find development tools and work from command prompt.