1KIWI(8)                             KIWI NG                            KIWI(8)
2
3
4

NAME

6       kiwi - Creating Operating System Images
7

SYNOPSIS

9          kiwi-ng [global options] service <command> [<args>]
10
11          kiwi-ng -h | --help
12          kiwi-ng [--profile=<name>...]
13                  [--temp-dir=<directory>]
14                  [--type=<build_type>]
15                  [--logfile=<filename>]
16                  [--logsocket=<socketfile>]
17                  [--loglevel=<number>]
18                  [--debug]
19                  [--debug-run-scripts-in-screen]
20                  [--color-output]
21                  [--config=<configfile>]
22                  [--kiwi-file=<kiwifile>]
23              image <command> [<args>...]
24          kiwi-ng [--logfile=<filename>]
25                  [--logsocket=<socketfile>]
26                  [--loglevel=<number>]
27                  [--debug]
28                  [--debug-run-scripts-in-screen]
29                  [--color-output]
30                  [--config=<configfile>]
31              result <command> [<args>...]
32          kiwi-ng [--profile=<name>...]
33                  [--shared-cache-dir=<directory>]
34                  [--temp-dir=<directory>]
35                  [--target-arch=<name>]
36                  [--type=<build_type>]
37                  [--logfile=<filename>]
38                  [--logsocket=<socketfile>]
39                  [--loglevel=<number>]
40                  [--debug]
41                  [--debug-run-scripts-in-screen]
42                  [--color-output]
43                  [--config=<configfile>]
44                  [--kiwi-file=<kiwifile>]
45              system <command> [<args>...]
46          kiwi-ng compat <legacy_args>...
47          kiwi-ng -v | --version
48          kiwi-ng help
49

DESCRIPTION

51       KIWI  NG  is an imaging solution that is based on an image XML descrip‐
52       tion.  Such a description is represented by a directory which  includes
53       at  least  one  config.xml  or .kiwi file and may as well include other
54       files like scripts or configuration data.
55
56       A collection of example image descriptions can be found on  the  github
57       repository here: https://github.com/OSInside/kiwi-descriptions. Most of
58       the descriptions provide a so called appliance image.  Appliance  means
59       that  it's a small, text only based image including a predefined remote
60       source setup to allow installation of missing software components at  a
61       later point in time.
62
63       KIWI  NG  operates in two steps. The system build command combines both
64       steps into one to make it easier to start with KIWI NG. The first  step
65       is  the  preparation  step  and if that step was successful, a creation
66       step follows which is able to create different image output types.
67
68       In the preparation step, you prepare a directory including the contents
69       of  your new filesystem based on one or more software package source(s)
70       The creation step is based on the result of the  preparation  step  and
71       uses  the  contents of the new image root tree to create the output im‐
72       age.
73
74       KIWI NG supports the creation of the following image types:
75
76       • ISO Live Systems
77
78       • Virtual Disk for e.g cloud frameworks
79
80       • OEM Expandable Disk for system deployment from ISO or the network
81
82       • File system images for deployment in a pxe boot environment
83
84       Depending on the image type a variety of different disk formats and ar‐
85       chitectures are supported.
86

GLOBAL OPTIONS

88       --color-output
89              Use  Escape Sequences to print different types of information in
90              colored output. The underlaying terminal has to understand those
91              escape  characters.  Error messages appear red, warning messages
92              yellow and debugging information will be printed light grey.
93
94       --config=<configfile>
95              Use specified runtime configuration file. If not  specified  the
96              runtime  configuration is looked up at ~/.config/kiwi/config.yml
97              or /etc/kiwi.yml
98
99       --debug
100              Print debug information on the commandline. Same as: '--loglevel
101              10'
102
103       --debug-run-scripts-in-screen
104              Run scripts called by kiwi in a screen session.
105
106       --logfile=<filename>
107              Specify  log  file.  The  logfile  contains detailed information
108              about the process. The special call: --logfile stdout sends  all
109              information to standard out instead of writing to a file
110
111       --logsocket=<socketfile>
112              send log data to the given Unix Domain socket in the same format
113              as with --logfile
114
115       --loglevel=<number>
116              specify logging level as number. Details about the available log
117              levels            can           be           found           at:
118              https://docs.python.org/3/library/logging.html#logging-levels
119              Setting a log level causes all message >= level to be displayed.
120
121                 ----------------------------
122                 | Level    | Numeric value |
123                 ----------------------------
124                 | CRITICAL | 50            |
125                 | ERROR    | 40            |
126                 | WARNING  | 30            |
127                 | INFO     | 20            |
128                 | DEBUG    | 10            |
129                 | NOTSET   | 0             |
130                 ----------------------------
131
132       --profile=<name>
133              Select profile to use. The specified profile must be part of the
134              XML description. The option can be specified multiple  times  to
135              allow using a combination of profiles.
136
137       --shared-cache-dir=<directory>
138              Specify  an alternative shared cache directory. The directory is
139              shared via bind mount between the build host and image root sys‐
140              tem  and  contains  information  about  package repositories and
141              their cache and meta  data.  The  default  location  is  set  to
142              /var/cache/kiwi.
143
144       --temp-dir=<directory>
145              Specify  an  alternative  base temporary directory. The provided
146              path is used as base directory to store temporary files and  di‐
147              rectories. By default /var/tmp is used.
148
149       --target-arch=<name>
150              Specify the image architecture. By default the host architecture
151              is used as the image architecture. If the specified architecture
152              name  does  not match the host architecture and is therefore re‐
153              questing a cross architecture image build, it's important to un‐
154              derstand  that  for  this  process to work a preparatory step to
155              support the image architecture and binary format on the building
156              host is required and not a responsibility of KIWI NG.
157
158       --type=<build_type>
159              Select  image  build type. The specified build type must be con‐
160              figured as part of the XML description.
161
162       --kiwi-file=<kiwifile>
163              Basename of kiwi file which contains the main  image  configura‐
164              tion  elements.  If not specified kiwi searches for a file named
165              config.xml or a file matching *.kiwi
166
167       --version
168              Show program version
169

EXAMPLE

171          $ git clone https://github.com/OSInside/kiwi
172
173          $ sudo kiwi-ng system build \
174              --description kiwi/build-tests/x86/leap/test-image-disk \
175              --set-repo obs://openSUSE:Leap:15.3/standard \
176              --target-dir /tmp/myimage
177

AUTHOR

179       Marcus Schäfer
180
182       2023, Marcus Schäfer
183
184
185
186
1879.25.16                          Oct 16, 2023                          KIWI(8)
Impressum