Skip to content

yast/yast-firstboot

Repository files navigation

YaST - System Configuration at First-Boot

Workflow Status OBS Coverage Status

Description

This is a special YaST module that allows users to configure pre-installed systems to match their needs, e.g., language, network settings, root password, etc.

See:

The workflow is defined in a control file, which uses the same format as the Installer control file. The default control file can be found in control directory.

More subject-specific pieces of information can be found in the doc directory.

Development

This module is developed as part of YaST. See the development documentation.

Getting the Sources

To get the source code, clone the GitHub repository:

$ git clone https://github.com/yast/yast-firstboot.git

If you want to contribute into the project you can fork the repository and clone your fork.

Testing Environment

##To test your first-boot workflow

  1. Install yast2-firstboot package from media or directly from sources at GitHub
  2. Copy your firstboot control file to /etc/YaST2/firstboot.xml
  3. Enable first boot at startup sudo systemctl enable YaST2-Firstboot.service
  4. Make sure this file exists sudo touch /var/lib/YaST2/reconfig_system
  5. Reboot the system
  6. While booting again, YaST2-Firstboot service checks for existence of /var/lib/YaST2/reconfig_system and starts the configuration workflow

Contact

If you have any question, feel free to ask at the development mailing list or at the #yast IRC channel on libera.chat.