This guide describes the types of Clear Linux OS images available, where to download them, how to verify the integrity of an image, and how to decompress it.

Instructions for other operating systems are available:

Image types

Clear Linux* OS offers many types of images for different platforms and environments.

The naming convention of a Clear Linux OS image filename is:

clear-[version number]-[image type].[compression type]
  • The [version number] field specifies the version number.
  • The [image type] field specifies the type of image and its corresponding file format.
  • The [compression type] field specifies the compression type. Two types of compressions are used: GNU* zip (.gz) and XZ (.xz).

Table 1 lists the currently available images that are platform independent. Table 2 lists the currently available images that are platform specific.

Table 1: Types of platform-independent Clear Linux OS images
Image Type Description
installer.img Preferred image of Clear Linux OS with interactive installer.
installer.iso ISO of Clear Linux OS with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key)
live.img Image for live booting into memory, without requiring installaton.
Table 2: Types of platform-specific Clear Linux OS images
Image Type Description
azure.vhd Virtual Hard Disk for use on Microsoft* Azure* cloud platform
azure-docker.vhd Virtual Hard Disk for use on Microsoft Azure cloud platform with Docker* pre-installed
azure-machine-learning.vhd Virtual Hard Disk for use on Microsoft Azure cloud platform with the machine-learning-basic bundle installed
cloud.img Image for use by cloud deployments such as OpenStack*
containers.img Image for use by Clear Containers runtime. Includes optimized kernel for Clear Containers.
hyperv.vhdx Virtual Hard Disk for use with Microsoft Hyper-V* hypervisor. Includes optimized kernel for Hyper-V.
kvm.img Image for booting in a simple VM with start_qemu.sh. Includes optimized kernel for KVM.
vmware.vmdk Virtual Machine Disk for VMware* platforms inclduing Player, Workstation, and ESXi.

Verify the integrity of the Clear Linux OS image

Before you use a downloaded Clear Linux OS image, verify its integrity. This action eliminates the small chance of a corrupted image due to download issues. To support verification, each released Clear Linux OS image has a corresponding SHA512 checksum file designated with the suffix -SHA512SUMS.

  1. Download the corresponding SHA512 checksum file of your Clear Linux OS image.

  2. Start the Terminal app.

  3. Go to the directory with the downloaded image and checksum files.

  4. Verify the integrity of the image and compare it to its original checksum with the command:

    shasum -a512 ./clear-[version number]-[image type].[compression type] | diff ./clear-[version number]-[image type].[compression type]-SHA512SUMS -
    

If the checksum of the downloaded image is different than the original checksum, the differences will be displayed. Otherwise, an empty output indicates a match and your downloaded image is good.

Decompress the Clear Linux OS image

We compress all released Clear Linux OS images by default with either GNU zip (.gz) or xz (.xz). The compression type we use depends on the target platform or environment. To decompress the image, follow these steps:

  1. Start the Terminal app.

  2. Go to the directory with the downloaded image.

  3. Use the gunzip command to decompress either compression type. For example:

    gunzip clear-[version number]-[image type].xz
    gunzip clear-[version number]-[image type].gz