Installation

Note

This document describes how to install KIWI NG.

Apart from the preferred method of installing KIWI NG via a distribution package manager, it is also available on pypi and can be installed using Python’s package manager, pip, as follows:

$ sudo pip install kiwi

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:

Open the URL https://download.opensuse.org/repositories/Virtualization:/Appliances:/Builder in your browser.
Right-click on the link of your preferred operating system and copy the URL. In Firefox, it is the menu Copy link address.
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 \
      http://download.opensuse.org/repositories/Virtualization:/Appliances:/Builder/<DIST> \
      kiwi-appliance-builder
```

Install KIWI NG:

$ sudo zypper --gpg-auto-import-keys install python3-kiwi

Note

Other Distributions

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

$ sudo dnf config-manager \
      --add-repo https://download.opensuse.org/repositories/Virtualization:/Appliances:/Builder/<DIST>/Virtualization:Appliances:Builder.repo

$ sudo dnf install python3-kiwi

Installation from Distribution Repositories

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

Note

There are many packages that contain the name kiwi in their name; some of these are not even Python packages. Please double-check the package’s description to see whether it is actually the KIWI NG Appliance builder before installing it. Please also note that, depending on how the responsible packager has integrated KIWI NG into the distribution, the install name can be different from the instructions provided in: Installation from OBS.

To install KIWI NG for the desired distribution, run the following command:

Leap/Tumbleweed:

$ sudo zypper install python3-kiwi

Fedora/Rawhide:

$ sudo dnf install kiwi-cli

Example Appliance Descriptions

There are two places for example appliance descriptions:

The KIWI NG build tests:

The KIWI NG project itself hosts a collection of appliance descriptions that are used for integration testing of the KIWI NG builder itself. These descriptions are required to build prior to any KIWI NG release and are also used as the base for this documentation. Please check them out when working with this reference guide:

$ git clone https://github.com/OSInside/kiwi

$ tree -L 3 kiwi/build-tests

The KIWI NG community descriptions project:

There is a GitHub project hosting example appliance descriptions to be used with the next-generation KIWI NG. Contributions from the community make up the contents of this repository, and users who need an example for a specific use case and distribution can clone the project as follows:

$ git clone https://github.com/OSInside/kiwi-descriptions