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 http://download.opensuse.org/tumbleweed/appliances/

To be useful, these images require configuration using either Ignition or cloud-init. 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 https://en.opensuse.org/Kubic:MicroOS#Configuration.

NOTE: OpenSSH does not allow root login with a password. If you would like to be able to login via network, you need to add your ssh key.

Images for non-UEFI ARM boards

Untested images for different ARM boards (including Raspberry Pi 3 and Pine64) are available from: https://download.opensuse.org/repositories/devel:/kubic:/images/openSUSE_Factory_ARM/

During the first boot of this images, you need to set password or add a ssh key for remote login. There is some openSUSE Kubic and openSUSE MicroOS specific documentation available on https://en.opensuse.org/Kubic:MicroOS#Configuration.


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 suse-tftp-install/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=http://download.opensuse.org/tumbleweed/repo/oss/

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. [See

USB disk

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