Visit Azul.com Support

Get Started with Azul Platform Prime on APT Systems

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us
Note
 Need a different Linux distro? Go back to Azul Platform Prime Downloads.

These instructions guide you through the Azul Platform Prime installation for APT-based installation packages. APT packages are available for the following operating systems:

  • Debian

  • Ubuntu

Installing a Stream Build via Linux Package

Stream Builds are produced once a month, do not receive any security backports, and are free for development and evaluation. By downloading Stream Builds, you agree to the Azul Platform Prime Evaluation Agreement. For more information, see the Azul Platform Prime Roadmap.

  1. Import Azul’s public key:

    OS Command

    Debian

    		 
     
    curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg
echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zing/debian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/zing.list

    Ubuntu

    		 
     
    curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg
echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zing/ubuntu $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/zing.list
Note
 The generated file requires access permissions level 644. You can set this permission using chmod 644 azul.gpg.

  1. Update the information about available packages:

     
    sudo apt update

  2. Run the following command to install Azul Platform Prime:

     
    sudo apt install zing-jdk<version-number>

    Use the following strings to specify the JDK version number:

    JDK Version Version string

    JDK 8 x86

    1.8.0

    JDK 8 ARM64

    8.0.0

    JDK 11

    11.0.0

    JDK 13

    13.0.0

    JDK 15

    15.0.0

    JDK 17

    17.0.0

    JDK 21

    21.0.0

Installing a Downloaded Stable Build

Stable Builds require a license for use, contain only critical fix backports, and are produced on an ongoing basis.

  1. Download the build from the Azul Platform Prime Customer Downloads page.

  2. Import Azul’s public key:

     
    curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg
echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zing/ubuntu $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/zing.list
sudo apt update
Note
 The generated file requires access permissions level 644. You can set this permission using chmod 644 azul.gpg.

  1. Run the following command:

     
    sudo apt install ./<apt-installation-file>

    The <apt-installation-file> has the following form:

    zing<zulu_prime_version>-jdk<version>-<architecture>.deb

    For example:

    zing22.08.301.0-1-jdk17.0.5.0.101-linux_amd64.deb

Installing a Downloaded Stream Build

Stream Builds are available for development and trial use and include the latest major features. Stream builds are released regularly on a monthly basis.

  1. Download the build from the Azul JDK Downloads page.

  2. Run the following command:

     
    sudo apt install ./<apt-installation-file>

    The <apt-installation-file> has the following form:

    zing<zulu_prime_version>-jdk<version>-<architecture>.deb,

    For example:

    zing23.01.0.0-3-jdk17.0.6-linux_amd64.deb

Running Azul Platform Prime

Once you performed all installation steps, you can start running your Java applications with Azul Platform Prime as follows:

Note
 Starting from the 24.10 release, the install directory for x86_64 DEB packages changed to /usr/lib/jvm/<ZVM directory name>. For instance: /usr/lib/jvm/zing-jdk11.0.24.0.101-24.10.0.0-4-amd64.

  1. Verify the Java version:

     
    /opt/zing/zing-<jdk-version>/bin/java -version
# Or for 24.10 and newer
/usr/lib/jvm/zing-<jdk-version>/bin/java -version

    Sample output for Java 8:

     
    java version "1.8.0-zing_19.07.0.0"
Zing Runtime Environment for Java Applications (build 1.8.0-zing_19.07.0.0-b3)
Zing 64-Bit Tiered VM (build 1.8.0-zing_19.07.0.0-b4-product-linux-X86_64, mixed mode)

  2. You may want to set the JAVA_HOME environment variable to point to the Azul Platform Prime installation directory:

     
    export JAVA_HOME=/opt/zing/zing-<jdk-version>`.
# Or for 24.10 and newer
export JAVA_HOME=/usr/lib/jvm/zing-<jdk-version>/bin/java -version

What to do next

Read more about: