Introducing the Raw Disk Image Installer
19. Nov 2026 | Thorsten Kukuk | No License
Introducing the Raw Disk Image Installer
The Raw Disk Image Installer (rdi-installer) is a small, robust tool with exactly one job: get a raw disk image (openSUSE MicroOS, Tumbleweed, or anything else shipped as a .raw image) onto real hardware, as painlessly as possible, whether that hardware is in a rack of bare-metal servers in a data center far away or a single box on your desk.
Delivery
rdi-installer ships as two image types, built automatically in the openSUSE Appliances OBS project:
rdi-installer-<version>.<arch>.efi— a Unified Kernel Image (UKI). It can be put on an ESP partition or booted straight from a TFTP or an HTTP server by the UEFI firmware, over PXE, or over UEFI HTTP Boot. No USB stick required, no physical media to misplace. It runs entirely from RAM. Secure Boot is only supported if the openSUSE key is enrolled in the firmware.rdi-installer-<version>.<arch>.img— a classic USB stick image usingshimandsystemd-boot. Secure Boot is fully supported, as is the ability to customize the kernel command line during system startup. It also runs completely from a RAM disk, so the stick itself is never touched once the installer is up.
Install Images, Not Distros
The main purpose of rdi-installer is to write raw disk images to the target device. This tool does not configure or modify the image. Adjusting the image has to happen at the first boot, e.g. with ignition or combustion. It can write images compressed with xz, gzip, bzip2, or zstd, decompressing them on the fly as they’re written to disk.
Since supply-chain integrity matters, every downloaded image is checked: rdi-installer automatically looks for a GPG-signed SHA256 checksum file alongside the image and verifies it with gpgv before trusting it. Images signed with openSUSE’s official key are verified out of the box; your own signing key can be imported at boot with a single rdii.pubkey option.
If no image is pre-selected, the user can choose available images from a list, based on the SHA256SUMS file at a remote URL, by default https://download.opensuse.org/tumbleweed/appliances/. The list is filtered by architecture and file extension and verified with the GPG checksum.
Built for Zero-Touch Automation
All steps can be automated, depending on your requirements:
- Full autoinstall mode: point it at an image and a device via kernel command line or a simple config file, and
rdi-installerinstalls without any human in the loop — then reboots, powers off, or returns to a menu, exactly as configured. - Network configuration from the kernel command line or configuration file:
rdii-networkdunderstands dracut-style and linuxrcip=,ifcfg=, VLANs, static routes, and DHCP options, so no manual configuration step is necessary. - Remote access and proxies: It is possible to enable SSH, inject authorized keys, and configure an HTTP proxy from boot parameters or configuration files fetched from the same place as the UKI.
- Software/MD RAID 1: install straight onto a two-disk mirror by specifying a second device alongside your target. The image needs to be prepared for this beforehand;
rdi-installerwill not modify the image itself. - SSH host key preservation:
rdi-installercan optionally back up the existing SSH host keys before wiping the disk and restore them afterward, so monitoring and automation don’t choke on a “host key changed” warning. - A single configuration file is fetched automatically from the same location as the installer itself was booted, as long as the UEFI firmware provides this information. This lets you pre-configure installation source, target device, network, proxy, and SSH settings.
Text UI
rdi-installer comes with a clean, keyboard-driven text UI (see the Quick Guide for a full walkthrough with screenshots): pick a keyboard layout, choose an image from a download server (filtered by architecture, or not — flashing an aarch64 image for a Raspberry Pi from an x86-64 host works too), browse for a local image, select a target disk from a list that shows size, model, and whether it is the boot device, and confirm before anything destructive happens.
Download
The images are available in the Tumbleweed Appliance directory: https://download.opensuse.org/tumbleweed/appliances/?P=rdi
Categories: blog
Tags: