Visit Support

Installation Issues

Looking for Zing? The Azul Zing Virtual Machine is now Azul Zulu Prime Builds of OpenJDK and part of Azul Platform Prime. Learn more.

If you received an error or warning message during Azul Zulu Prime Builds of OpenJDK (Azul Zulu Prime JVM) installation or configuration, inspect the message and complete the steps listed for your operating system. In addition, you might want to study the following typical issues and the corresponding solutions:

Error Description Solution

Permissions Denied Error


/usr/bin/ld: Permission denied


ZST installation requires access to /usr/bin/ld. Ensure acceptable permissions are set. For example:

\# chmod 755 /usr/bin/ld

Operating System is not supported


You cannot find a Azul Zulu Prime JVM Installation for your target operating system.


  1. Consult the list of the supported operating systems and environments in the Azul Zulu Prime Builds of OpenJDK System Requirements document.

  2. Сontact [email protected] for any related questions.

Conflict with settings configured for other JVMs

Azul Zulu Prime JVM use on machines where there are other installed JVMs that have overlaps in environment and path settings leads to unwanted behaviors.

Ensure your PATH and JAVA_HOME variables are set accurately in the shell or context of your runtime application.

Ensure you have the proper Azul Zulu Prime JVM architecture for your OS and kernel. Using incorrect processor type or bitness may fail to operate at all.

See the Azul Zulu Prime Builds of OpenJDK System Requirements document for more details.

Cannot Apply Azul Platform Prime Trial Keyfiles

Question: You’ve downloaded Azul Platform Prime and obtained a keyfile from Azul. Now what?

Solution: The simplest step is pasting your keyfile into a folder created during Azul Zulu Prime JVM installation:

Copy the license file, license, to the /etc/zing/ directory of your target host.

If you want to use any other file location, then you must add -XX:ZingLicenseFile=<filename> to your Azul Zulu Prime JVM instance launch command.

Licenses allow Azul Zulu Prime JVM instance launches up to the end of the day they are due to expire within the local timezone specified in the keyfile.

Free trial keys last 21 days from the time of download (not the time of installation).

To extend your trial after expiry, and request a keyfile renewal, please contact [email protected].

Cannot fetch the license key


Failed to fetch the license key file because the target system does not have wget.


Сontact [email protected] to get a keyfile directly from Azul.

Cannot attach an APT repository


You cannot attache an APT repository, because $(lsb_release -sc) command does not work in your system:

$ sudo apt-add-repository "deb $(lsb_release -sc) main"


Use any of Ubuntu release name constants, such as "xenial", "trusty", or "precise". For example:

$ sudo apt-add-repository "deb trusty main"

Problems with installing Azul Platform Prime on Debian and Amazon Linux


Failed to install Azul Platform Prime on Debian and Amazon Linux when Linux headers are not present.


  1. Install Linux Headers.

    For Debian, run the following command:

    apt-get install linux-headers-$(uname -r)

    For Amazon Linux, run:

    yum install kernel-devel-$($uname -r) dkms build -m zing_mm -v <zst-version> dkms install -m zing_mm -v <zst-version>

  2. Run the system-config-zing-memory command, once the Linux headers are installed.

Azul Zulu Prime JVM and ZST Compatibility Issue


Azul Zulu Prime JVM stops during startup in case of incompatible Azul Zulu Prime JVM and ZST versions.

Sample Message:

$ /usr/bin/java -version

Error occurred during initialization of VM

Zing VM Error: This Zing VM requires ZST 5.15 or later.

Zing VM Error: Found zst version: 'zst-'.

Zing VM Error: See 'System Requirements guide' for more information.


Review the Azul Platform Prime Component Version Compatibility Reference and install an appropriate Azul Platform Prime component.

Kernel Mismatch on a DKMS RHEL, SLES, or Ubuntu Systems


Error! Your kernel headers for kernel <kernel version> cannot be found at

/lib/modules/<kernel version>/build



Run the following commands to fix the error:


sudo yum install kernel-devel-2.6.32-71.el6.x86_64

sudo dkms build -m zing_mm -v

sudo dkms install -m zing_mm -v


sudo zypper install kernel-devel-3.0.101-0.35-default

sudo dkms build -m zing_mm -v

sudo dkms install -m zing_mm -v

For Ubuntu:

apt-get install kernel-devel-$(uname -r)

Once you resolve the errors listed in the error message, run system-config-zing-memory.

zing-obtain-trial-license fails with openssl 1.1

When running

sudo zing-obtain-trial-license -f -p TrialLicensePasscode

you may get the following error message:

URLError = [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

You have to install a separate package "ca-certificates":

sudo apt-get install ca-certificates

ZST support for kernel version is unavailable

Question: What if the kernel I am running on is not listed in the supported kernel list at

Sample error message :

/usr/lib/zing/bin/tar: zm.o_3.10.0-862.25.3.el7.x86_64: Not found in archive

/usr/lib/zing/bin/tar: zm_linux.o_3.10.0-862.25.3.el7.x86_64: Not found in archive

/usr/lib/zing/bin/tar: Exiting with failure status due to previous errors

zing-memory: INFO: Zing ZST support for kernel 3.10.0-862.25.3.el7.x86_64 is unavailable. Please upgrade ZST.

Fatal error: os::safeSystem: command '/etc/init.d/zing-memory restart' failed.


In most cases, the latest Feature and Update releases of ZST have support for required kernels.

The latest release of ZST may happen to miss support for a kernel and display the error message if the kernel is:

  • a custom kernel

  • a part of the Extended Update Support (EUS) Subscription

  • no longer available in the target OS repository

File a bug and Azul team will do their best to add support for the kernel you need.

Please install ZST Error


Zing VM Error: DLERROR: cannot open shared object file: No such file or directory

Zing VM Error: Please install ZST (Zing System Tools)

Use Azul Zulu Prime JVM or higher. See Azul Zulu Prime System Tools Libraries Retirement from Containers for details.

If you cannot find any workaround or need additional assistance, contact [email protected].