This document describes how to install KIWI NG. Apart from the preferred method to install KIWI NG via rpm, it is also available on pypi and can be installed via pip.

Installation from OBS

The most up to date packages of KIWI NG can be found on the Open Build Service in the Virtualization:Appliances:Builder project.

To install KIWI NG, follow these steps:

  1. Open the URL in your browser.

  2. Right-click on the link of your preferred operating system and copy the URL. In Firefox it is the menu Copy link address.

  3. Insert the copied URL from the last step into your shell. The DIST placeholder contains the respective distribution. Use zypper addrepo to add it to the list of your repositories:

    $ sudo zypper addrepo<DIST> appliance-builder

    If your distribution is not using zypper, please use your package manager’s appropriate command instead. For dnf that is:

    $ sudo dnf config-manager --add-repo<DIST>/Virtualization:Appliances:Builder.repo
  4. Add the repositories’ signing-key to your package manager’s database. For rpm run:

    $ sudo rpm --import

    And verify that you got the correct key:

    $ rpm -qi gpg-pubkey-74cbe823-* | gpg2
    gpg: WARNING: no command supplied.  Trying to guess what you mean ...
    pub   dsa1024 2009-05-04 [SC] [expires: 2020-10-09]
    uid           Virtualization:Appliances OBS Project <>


rpm requires network utilities in order to download and import remote keys. Make sure curl is installed before trying to import remote keys using rpm.

Alternatively, the package manager, if not executed in non-interactive mode, will ask you to trust or not the public key of the new repository when refreshing repositories or installing new packages. If trusted the package manager will automatically import it.

  1. Install KIWI NG:

    $ sudo zypper in python3-kiwi

Installation from your distribution’s repositories


There are many packages that contain the name KIWI NG in their name, some of these are even python packages. Please double check the packages’ description whether it is actually the KIWI NG Appliance builder before installing it.

Some Linux distributions ship KIWI NG in their official repositories. These include openSUSE Tumbleweed, openSUSE Leap, and Fedora since version 28. Note, these packages tend to not be as up to date as the packages from OBS, so some features described here might not exist yet.

To install KIWI NG on openSUSE, run the following command:

$ sudo zypper install python3-kiwi

On Fedora, use the following command instead:

$ sudo dnf install kiwi-cli

Installation from PyPI

KIWI NG can be obtained from the Python Package Index (PyPi) via Python’s package manager pip:

$ pip install kiwi

Example Appliance Descriptions

There is a GitHub project hosting example appliance descriptions to be used with the next generation KIWI NG. Users who need an example to start with should clone the project as follows:

$ git clone