Jump to: navigation, search
openSUSE MicroOS is a modern Linux Operating System, designed for containers and optimized for large deployments. It is the operating system part of openSUSE Kubic, a Container as a Service platform.

What is openSUSE MicroOS?

openSUSE MicroOS is a modern Linux Operating System, designed for container hosts and optimized for large deployments. It inherits the openSUSE Tumbleweed and SUSE Linux Enterprise knowledge while redefining the operating system into a small, efficient and reliable distribution.

openSUSE MicroOS is not a separate distribution, but is bundled as part of openSUSE Kubic, a Container as a Service platform. However, there is a system role "openSUSE MicroOS" which can be selected during installation to get a standalone openSUSE MicroOS system installed. openSUSE Kubic itself is an openSUSE Tumbleweed variant that shares technology with SUSE CaaS Platform.

In a Nutshell

  • OS focused only on containers
    • Minimal images designed for one special Use Case
  • Optimised for large deployments, but capable as a single machine container-host
    • Reduced end-user interactions
  • An always up-to-date Operating System
    • Safe way to update the system


  • Btrfs with snapshots and rollback for transactional updates
  • Read-only root filesystem
  • cloud-init for initial system configuration during first boot
  • Rolling Release: Every time we release a new openSUSE Tumbleweed snapshot, we will also release a new openSUSE Kubic snapshot
  • Designed to fit perfectly into existing openSUSE or SUSE Linux Enterprise environments
  • Podman/CRI-O and Docker Container Runtimes both available


openSUSE Kubic and thus openSUSE MicroOS are RPM based distributions and can be installed from media or with PXE/tftpboot with YaST2. For mass-deployment, an autoyast profile can be created. For openSUSE Kubic this is done by velum, the administration dashboard for the cluster. For openSUSE MicroOS, there is a script create_autoyast_profile, with which an autoyast profile can be created.


openSUSE Kubic comes with a RPM containing a tftpboot installer: tftpboot-installation-openSUSE-Tumbleweed-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.

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.

Hardware requirements

Please see: https://en.opensuse.org/Kubic:SystemRequirements#openSUSE_MicroOS


ISO images for installation

An ISO image for manual install can be downloaded from here: http://download.opensuse.org/tumbleweed/iso/openSUSE-Tumbleweed-Kubic-DVD-x86_64-Current.iso For openSUSE MicroOS select the corresponding system role during installation.

Images for virtualisation environments

Untested images for different virtualisation environments are available from: https://download.opensuse.org/repositories/devel:/kubic:/images:/experimental/images/

During the first boot of this images, you need to set a password or add a ssh key for remote login with cloud-init. There is some openSUSE Kubic and openSUSE MicroOS specific Documentation available.


Mailing list


#kubic on the freenode IRC network is the channel that the Kubic project uses for live chat.

See also

Related articles

External links