Building Images


This document provides an overview about the supported KIWI image types. Before building an image with KIWI it’s important to understand the different image types and their meaning.

  • ISO Hybrid Live Image

    An iso image which can be dumped on a CD/DVD or USB stick and boots off from this media without interfering with other system storage components. A useful pocket system for testing and demo and debugging purposes.

  • Virtual Disk Image

    An image representing the system disk, useful for cloud frameworks like Amazon EC2, Google Compute Engine or Microsoft Azure.

  • OEM Expandable Disk Image

    An image representing an expandable system disk. This means after deployment the system can resize itself to the new disk geometry. The resize operation is configurable as part of the image description and an installation image for CD/DVD, USB stick and Network deployment can be created in addition.

  • PXE root File System Image

    A root filesystem image which can be deployed via KIWI’s PXE netboot infrastructure. A client configuration file on the pxe server controls how the root filesystem image should be deployed. Many different deployment strategies are possible, e.g root over NBD, AoE or NFS for diskless and diskfull clients.

  • Docker Container Image

    An archive image suitable for the docker container engine. The image can be loaded via the docker load command and works within the scope of the container engine

Supported Distributions

KIWI can build the above image types for distributions which are equal or newer compared to the following list:

  • CentOS 7

  • Fedora 25

  • openSUSE Leap 42

  • Red Hat Enterprise 7

  • SUSE Linux Enterprise 12

  • openSUSE Tumbleweed

  • Ubuntu 16.04 (Xenial Xerus)

For anything older please consider to use the legacy KIWI version v7.x For more details on the legacy kiwi, see: Legacy KIWI vs. Next Generation.