os type

Contains the configuration options for the OS.

Added in v0.3.

hostname [string]

Specifies the hostname for the OS.

Implemented by writing to the /etc/hostname file.

Example:

os:
  hostname: example-image

Added in v0.3.

kernelCommandLine [kernelCommandLine]

Specifies extra kernel command line options.

Added in v0.3.

packages [packages]

Remove, update, and install packages on the system.

Added in v0.3.

additionalFiles [additionalFile[]]

Copy files into the OS image.

os:
  additionalFiles:
  - source: files/a.txt
    destination: /a.txt

  - content: |
      abc
    destination: /b.txt
    permissions: "664"

additionalDirs [dirConfig[]]

Copy directories into the OS image.

This property is a list of dirConfig objects.

Example:

os:
  additionalDirs:
    # Copying directory with default permission options.
    - source: "path/to/local/directory/"
      destination: "/path/to/destination/directory/"
    # Copying directory with specific permission options.
    - source: "path/to/local/directory/"
      destination: "/path/to/destination/directory/"
      newDirPermissions: 0644
      mergedDirPermissions: 0777
      childFilePermissions: 0644

Added in v0.3.

groups [group]

Used to add and/or update user groups.

Example:

os:
  groups:
  - name: test

Added in v0.16.

users [user]

Used to add and/or update user accounts.

Example:

os:
  users:
  - name: test

Added in v0.3.

modules [module[]]

Used to configure kernel modules.

Added in v0.3.

overlays [overlay[]]

Used to add filesystem overlays.

Added in v0.6.

bootloader [bootloader]

Defines the configuration for the boot-loader.

Added in v0.8.

uki [uki]

Used to create UKI PE images and enable UKI as boot entries.

Added in v0.8.

selinux [selinux]

Options for configuring SELinux.

Example:

os:
  selinux:
    mode: permissive

Added in v0.3.

services [services]

Options for configuring systemd services.

os:
  services:
    enable:
    - sshd

Added in v0.3.

imageHistory [string]

Options for configuring image history.

Set value to none to disable.

To learn more about image history, refer to the Image History Concept documentation.

os:
  imageHistory: none

Added in v0.8.