osinfo-install-script(1)

osinfo-install-script1

Generate a script for automated installation

Usage

osinfo-install-script {[OPTIONS ...] MEDIA-FILE | OS-ID}

Overview

Generate a script suitable for performing an automated installation of "MEDIA_FILE" or "OS-ID". "MEDIA_FILE" should be a path to an installer or live media (typically an ISO file). "OS-ID" should be a URI identifying the operating system, or its short ID.

By default a script will be generated for a "JEOS" style install.

Options

--profile=NAME

Choose the installation script profile. Defaults to "jeos", but can also be "desktop", or a site specific profile name

--installation-source=NAME

Set the installation source to be used with the installation script. Defaults to "media", but can also be "network".

--config=key=value

Set the configuration parameter "key" to "value".

--config-file=config-file

Set the configurations parameters according to the config-file passed.

Note that use of --config-file is strongly recommended if the user or admin passwords need to be set. Providing passwords directly using --config= is insecure as the password is visible to all processes and users on the same host.

Configuration keys

The following configuration keys are available

"hardware-arch"

The hardware architecture

"l10n-timezone"

The local timezone

"l10n-keyboard"

The local keyboard layout

"l10n-language"

The local language

"admin-password"

The administrator password This option has been deprecated, use --config-file for setting the admin password.

"user-password"

The user password This option has been deprecated, use --config-file for setting the user password.

"user-login"

The user login name

"user-realname"

The user real name

"user-autologin"

Whether to automatically login the user

"user-admin"

Whether to give the user administrative privileges

"reg-product-key"

The software registration key

"reg-login"

The software registration user login

"reg-password"

The software registration user password

Configuration file format

The configuration file must consist in a file which contains a "install-script" group and, under this group, "key"="value" pairs, as shown below:

  [install-script]
  l10n-timezone=GMT
  l10n-keyboard=uk
  l10n-language=en_GB
  admin-password=123456
  user-login=berrange
  user-password=123456
  user-realname="Daniel P Berrange"

Example usage

The following usages generate a Fedora 30 kickstart script:

  # osinfo-install-script \
         --profile jeos \
         --config-file /path/to/config/file \
         fedora30
  # osinfo-install-script \
         --profile jeos \
         --config l10n-timezone=GMT \
         --config l10n-keyboard=uk \
         --config l10n-language=en_GB \
         --config admin-password=123456 \
         --config user-login=berrange \
         --config user-password=123456 \
         --config user-realname="Daniel P Berrange" \
         fedora30

Exit status

The exit status will be 0 if an install script is generated, or 1 on error

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

--config-file since Debian 11 (Bullseye); --installation-source since Debian 11 (Bullseye).

Authors

Daniel P. Berrange <[email protected]>

License

"osinfo-install-script" is distributed under the termsof the GNU LGPL v2 license. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE

From libosinfo 1.12.0-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.