Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

jeos-firstboot

Description

jeos-firstboot allows initial configuration and adjustments of a Linux system using text based dialogs.

It is a lightweight and customisable firstboot wizard that allows to set basic system settings during and after the first boot of an image. Including showing the license and prompt for language, keyboard, timezone, root passsword and network configuration..

This is mainly developed for openSUSE and SUSE Linux Enterprise Server JeOS images. For more information visit the JeOS wiki.

Getting Started

jeos-firstboot can be extended using separate modules, writing a script with the appropriate format and have it installed under /usr/lib/share/jeos-firstboot/modules will make this module be executed. For more information on modules format please check jeos-firstboot extensions

Installation

The RPM package is developed in openSUSE OBS devel package

You can also get binaries RPM for openSUSE flavours at package download

Usage

jeos-firstboot is used as two systemd services jeos-firstboot.service and jeos-firstboot-snapshot, for using it you need to copy the appropriate service files and enable it.

You can check the example in the RPM package for installation.

The service is controlled by a file, so after installing it you should be sure that your system is configured appropriately

        # Enable jeos-firstboot
        mkdir -p /var/lib/YaST2
        touch /var/lib/YaST2/reconfig_system

        systemctl mask systemd-firstboot.service
        systemctl enable jeos-firstboot.service

Beside the service that runs on firstboot there is also a tool to change configuration in a running system, this will also be installed and available as jeos-config

jeos-config usage:

Usage: jeos-config [OPTION...] [CONFIG_NAME]
Configure system settings using an interactive dialog

        -h              shows this usage help
        locale          Show configuration for locale
        keytable        Show configuration for keyboard
        timezone        Show configuration for timezone
        password        Show configuration for password
        network         Show configuration for network
        raspberrywifi   Show configuration for raspberrywifi

Additional modules (like raspberrywifi) are shown if present.

If no parameter is given it shows a dialog for selection.

Contributing

Any contributions you make are greatly appreciated.

Feel free to create any Issues and send pull requests to this repository.

License

Distributed under the MIT License. See LICENSE for more information.

About

Lightweight firstboot wizard systemd service for SLE and openSUSE JeOS Images

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages