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