Get Started with Zing® 15 in a Docker Container

Need a different Linux distro? Go back to the Zing Quick Start Guide

Note: Our software distributions are signed by an OpenPGP key when appropriate. To verify your download, see Product Signing Keys (OpenPGP) for details.

These instructions introduce you to the quick and easy process of installing Zing in a container on the plarform of your choice. Docker is used as an example below.

Step 1: Get a Zing License

    1. If you have not already done so, sign up for a Zing Trial License in order to obtain your Zing Trial Token.
    2. Check the Zing Trial Token email you received from Azul and locate your Zing Trial Token (if you did not receive the email in your inbox, check your Spam or Junk email folders).
    3. Download your license:
    4. wget -O- > <some_path>/ZING_LICENSE

Step 2: Install Zing in a Container

  1. Create and run a Docker container instance using the sample Dockerfile below:
    From ubuntu:18.04
    RUN apt-get update && \
      apt-get install -y software-properties-common && \
    # Copy Azul's public key
      apt-key adv --keyserver hkps:// --recv-keys 0xB1998361219BD9C9 && \
    # Complete the installation (on Debian-based systems)
      /usr/bin/apt-add-repository "deb $(lsb_release -sc) main" && \
      apt-get update -y && \
      apt-get install zing-jdk15.0.0 -y
  3. Build a Zing Docker image:
  4. docker build -t zing-docker .
  5. Run the Zing Docker container and verify that the Zing Virtual Machine is successfully installed in a container:
  6. docker run -it --rm  --env ZING_LICENSE="`cat <some_path>/ZING_LICENSE`" zing-docker /opt/zing/zing-jdk15/bin/java -version

    The output should look similar to the snippet below:

    java version "15.0.2" 2021-03-18
    Java Runtime Environment Zing21.03.0.0+1-CA (build 15.0.2+7-MTS)
    Zing 64-Bit Tiered VM Zing21.03.0.0+1-CA (build 15.0.2-zing_21.03.0.0-b3-product-linux-X86_64, mixed mode)

    In case of issues, visit the Zing Community Forum.

You are now ready to start running your Java applications using the Zing Virtual Machine in a container environment.

See Also

Post Installation Tasks for Production Systems

Evaluate JVM Performance using jHiccup

Zing System Requirements

Zing Release Notes

Zing Online Documentation

Zing Troubleshooting Guide

Zing Knowledge Base