This wiki was updated to MediaWiki 1.37. If you notice any issues, please report them to admin[at]


Jump to: navigation, search

Installation of openSUSE Kubic


ISO images for installation

An ISO image for manual install can be downloaded from here:

Images for x86_64 virtualisation environments

Images tailored for various virtualization environments are available from

To be useful, these images require configuration using Ignition (the OpenStack flavor uses cloud-init instead). These tools are used to set password, add your SSH key for remote login and perform other initial boot configurations of your instance.

openSUSE Kubic and openSUSE MicroOS specific documentation is available at

Images for non-UEFI ARM boards

Untested images for different ARM boards (including Raspberry Pi 3 and Pine64) are available from:

You have to attach a USB drive with a configuration file for Ignition on the first boot, otherwise you will not be able to log in.


openSUSE Kubic and thus openSUSE MicroOS are RPM based distributions and can be installed from media or with PXE/tftpboot with YaST2 like openSUSE Tumbleweed. For mass-deployment, autoyast or Yomi can be used.


openSUSE Kubic comes with a RPM containing a tftpboot installer: tftpboot-installation-openSUSE-Kubic-<architecture> Install or unpack this RPM on your tftpboot server and follow the steps in the README to configure PXE boot for it. There is no need anymore to download the full ISO image and setup your own install server with it.

Quick instruction to setup a PXE boot server for legacy BIOS:

 zypper install tftpboot-installation-openSUSE-Kubic-x86_64
 systemctl enable --now tftp.socket
 systemctl enable --now 'srv-tftpboot-suse\x2dtftp\x2dinstall.mount'
 cd /srv/tftpboot
 cp -av /usr/share/tftpboot-installation/openSUSE-Kubic-x86_64/net/{message,pxelinux.*} .

Adjust /srv/tftpboot/pxelinux.cfg/default to look like:

 default kubic
 # install
 label kubic
   ipappend 2
   kernel suse-tftp-install/openSUSE-Kubic-x86_64/boot/x86_64/loader/linux
   append initrd=suse-tftp-install/openSUSE-Kubic-x86_64/boot/x86_64/loader/initrd instsys=tftp://TFTP_SERVER/suse-tftp-install/openSUSE-Kubic-x86_64/boot/x86_64/root install=

and adjust your message file.

Workaround for installing with kubeadm/MicroOS node roles from PXE boot

Currently when using the tumbleweed repository for the install= option in the PXE menu configuration, you will only be able to select default the installation roles from tumbleweed and not the kubeadm or MicroOS roles. As a workaround you can use the contents of the ISO to create an install repository specific to the Kubic PXE boot environment.

You will need approximately 1.5G of disk space on an HTTP server. Use your preferred archive extracting utility and extract the contents of the ISO file to the HTTP server. Next, configure your PXE menu to use your own server; install=http://<YOUR_SERVER>/<LOCATION_OF_KUBIC_FILES>/. As a sanity check, http://<YOUR_SERVER>/<LOCATION_OF_KUBIC_FILES>/control.xml should return an XML file which specifies the kubeadm_role and micro_os_role.

USB disk

The tfptboot installer for PXE boot can be written to an USB disk with the mksusecd command.