Get Started with Zing® 8 in a Docker Container

Need a different Linux distro? Go back to the Zing Quickstart 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 8 in a container on the plarform of your choice. Docker is used as an example below.

Step 1: Get a Zing License

  1. 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- https://trial-licenses.azul.com/redeem/Zing_Trial_Token > <some_path>/ZING_LICENSE

Step 2: Install Zing in a Container

  1. Create and run a Docker container instance using the sample Dockerfile below:
  2. 
    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://keyserver.ubuntu.com --recv-keys 0xB1998361219BD9C9 && \
     
    # Complete the installation (on Debian-based systems)
      /usr/bin/apt-add-repository "deb https://repos.azul.com/zing/ubuntu $(lsb_release -sc) main" && \
      apt-get update -y && \
      apt-get install zing-jdk1.8.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-jdk8/bin/java -version

    The output should look similar to the snippet below:

    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)

    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:

Zing System Requirements

Zing Troubleshooting Guide

Zing Virtual Machine Release Notes

Zing User’s Guide

Zing Community Forum