D-Installer is a new Linux installer born in the core of the YaST team. It is designed to offer re-usability, integration with third party tools and the possibility of building advanced user interfaces over it.
![]() |
![]() |
This new project follows two main motivations: to overcome some of the limitations of YaST and to serve as installer for new projects like SUSE ALP (Adaptable Linux Platform).
YaST is a mature installer and control center for SUSE and openSUSE operating systems. With more than 20 years behind it, YaST is a competent and flexible installer able to cover uncountable use cases. But time goes by, and the good old YaST is starting to show its age in some aspects:
- The architecture of YaST is complex and its code-base has too much technical debt.
- Designing and building rich and modern user interfaces is a real challenge.
- Sharing logic with other tools like Salt or Ansible is very difficult.
- Some in-house solutions like libyui makes more difficult to contribute to the project.
SUSE is working on its next generation operating system called ALP (Adaptable Linux Platform). ALP is designed to be a lean core system, moving most of the software and workloads to containers and virtual machines. For some cases, for example cloud and virtual machines, ALP based systems will be deployed with auto-installable images. But still there are quite some situations in which ALP must be installed in a more traditional way. A clear example consists on installing over bare metal where some system analysis is required beforehand. D-Installer is also intended to cover such use cases for ALP, offering a minimal but powerful installer able to support a wide range of scenarios (e.g., RAID, encryption, LVM, network storage, etc).
This project is designed as a service-client system, using D-Bus for process communication.
D-Installer consists on a set of D-Bus services and a web client (an experimental CLI is also available). The services use YaST-based libraries under the hood, reusing a lot logic already provided by YaST. Currently D-Installer comes with six separate services, although the list can increase in the future:
- D-Installer service: it is the main service which manages and controls the installation process.
- Software service: configures the product and software to install.
- Users service: manages first user creation and configuration for root.
- Language service: allows to configure the language and keyboard settings.
- Storage service: analyzes and prepares the storage devices in order to perform the installation.
- Questions service: helper service used for requesting information from clients.
D-Installer offers a web interface and its UI process uses the Cockpit's infrastructure to communicate with the D-Bus services.
There are two ways of running this project: a) by using a D-Installer live ISO image or b) by cloning and configuring the project.
The easiest way to give D-Installer a try is to grab a live ISO image and boot it in a virtual machine. This is also the recommended way if you only want to play and see it in action. If you want to have a closer look, then clone and configure the project as explained in the next section.
- multi-product: it can be used to install different products, like openSUSE Tumbleweed, Leap, Leap Micro or an experimental version of the SUSE ALP ContainerHost OS.
- ALP only: it only contains the definition for the experimental SUSE ALP ContainerHost OS, although the rest of the content is pretty much the same than the multi-product version.
You can run D-Installer from its sources by cloning and configuring the project:
$ git clone https://github.com/yast/d-installer
$ cd d-installer
$ ./setup.sh
Start the d-installer service
cd service; sudo bundle exec bin/d-installer
Then point your browser to http://localhost:9090/cockpit/@localhost/d-installer/index.html and that's all.
Note that the setup.sh script installs the required dependencies to build and run the project and it also configures the D-Installer services and cockpit. Alternatively, just go through the following instructions if you want to configure it manually:
- Install dependencies:
$ sudo zypper in gcc gcc-c++ make openssl-devel ruby-devel augeas-devel npm cockpit
- Setup the D-Installer services:
$ sudo cp service/share/dbus.conf /usr/share/dbus-1/system.d/org.opensuse.DInstaller.conf
$ cd service;
$ bundle config set --local path 'vendor/bundle';
$ bundle install
$ cd -
- Setup the web UI:
$ sudo ln -s `pwd`/web/dist /usr/share/cockpit/d-installer
$ sudo systemctl start cockpit
$ cd web
$ make devel-install
$ cd -
- Start the services:
- beware that D-Installer must run as root (like YaST does) to do hardware probing, partition the disks, install the software and so on.
- Note that
setup.sh
sets up D-Bus activation so starting manually is only needed when you prefer to see the log output upfront.
$ cd service
$ sudo bundle exec bin/d-installer
- Check that D-Installer services are working with a tool like busctl or D-Feet if you prefer a graphical one:
$ busctl call org.opensuse.DInstaller.Language /org/opensuse/DInstaller/Language1 \
org.opensuse.DInstaller.Language1 AvailableLanguages
$ busctl call org.opensuse.DInstaller.Language /org/opensuse/DInstaller/Language1 \
org.freedesktop.DBus.Properties GetAll s org.opensuse.DInstaller.Language1
If you want to contribute to D-Installer, then please open a pull request or report an issue. You can also have a look to our road-map.