1LIVECD-CREATOR(8)                LiveCD Tools                LIVECD-CREATOR(8)
2
3
4

NAME

6       livecd-creator - creates live CD or DVD images.
7

SYNOPSIS

9       livecd-creator [OPTIONS]
10

DESCRIPTION

12       livecd-creator creates live CD or DVD images (ISO images) from
13       kickstart files. Kickstart files contain information about packages and
14       configuration settings which are used to build the image.
15

OPTIONS

17       -h, --help
18           Shows the help message and exits.
19

IMAGE OPTIONS

21       These options define the created image.
22
23       -c KSCFG, --config=KSCFG
24           Path to kickstart configuration file.
25
26       -b BASE_ON, --base-on=BASE_ON
27           Add packages to an existing live CD iso9660 image.
28
29       -f FS_LABEL, --fslabel=FS_LABEL
30           Defines the file system label. The default is based on the
31           configuration name.
32
33       --title=TITLE
34           Title used by syslinux.cfg file.
35
36       --product=PRODUCT
37           Product name used in syslinux.cfg boot stanzas and countdown.
38
39       -p, --plugins
40           Use DNF plugins during image creation.
41
42       --compression-type=COMPRESS_ARGS
43           Specify a compressor recognized by mksquashfs.  "xz" is the default
44           and works with 2.6.38 and later kernels.  "gzip" works with all
45           kernels.  "lzo" works with 2.6.36 and later kernels.  "lzma" will
46           only work with custom kernels.  "xz1m" is interpreted as "xz -b 1M
47           -Xdict-size 1M -norecovery".  Set to "None" to force reading the
48           compressor used in BASE_ON.  If "gzip" is used, the -comp option is
49           not passed to mksquashfs to allow the use of older versions of
50           mksquashfs.  Multiple arguments should be specified in one string,
51           i.e., "--compression-type "type arg1 arg2 ..."".
52
53       --releasever=VER
54           Set the value to substitute for $releasever in kickstart repo urls.
55

SYSTEM DIRECTORY OPTIONS

57       These options define directories used on your system for creating the
58       live image.
59
60       -t TMPDIR, --tmpdir=TMPDIR
61           defines the temporary directory to use. The default directory is
62           /var/tmp.
63
64       --cache=CACHEDIR
65           Defines the cache directory to use (default: private cache).
66
67       --cacheonly
68           Work offline from cache, use together with --cache (default:
69           False).
70
71       --nocleanup
72           Skip cleanup of temporary files.
73

DEBUGGING OPTIONS

75       These options control the output of logging information during image
76       creation.
77
78       -d, --debug
79           Output debugging information.
80
81       -v, --verbose
82           Output verbose progress information.
83
84       -q, --quiet
85           Supress stdout.
86
87       --logfile=FILE
88           Save debug information to FILE.
89

EXAMPLES

91       Barebones LiveCD
92
93       livecd-creator \
94       --config=/usr/share/livecd-tools/livecd-fedora-minimal.ks
95
96       Fedora Desktop Live CD
97
98       livecd-creator \
99       --config=/usr/share/livecd-tools/livecd-fedora-desktop.ks \
100       --fslabel=Fedora9-LiveCD-foo
101

REPO EXTENSIONS

103       livecd-creator provides for some extensions to the repo commands
104       similar to what DNF supports. The strings $arch, $basearch and
105       $releasever are replaced with the system arch, basearch and release
106       version respectively.  When no --releasever is passed it defaults to
107       the current system's version.  This allows the use of repo commands
108       such as the following:
109
110       repo --name=fedora
111       --mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=fedora-$releasever&arch=$basearch
112
113       Note that in a chroot environment (like koji) the rpmdb is not
114       available, so either don't use $releasever in that case, or pass
115       --releasever=VER.
116

CONTRIBUTORS

118       David Zeuthen, Jeremy Katz, Douglas McClendon and a team of many other
119       contributors. See the AUTHORS file in the source distribution for the
120       complete list of credits.
121

BUGS

123       Report bugs to the mailing list
124       <http://www.redhat.com/mailman/listinfo/fedora-livecd-list> or directly
125       to Bugzilla <http://bugzilla.redhat.com/bugzilla/> against the "Fedora"
126       product, and the "livecd-tools" component.
127

129       Copyright (C) Fedora Project 2008,2009,2020, and various contributors.
130       This is free software. You may redistribute copies of it under the
131       terms of the GNU General Public License
132       <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the
133       extent permitted by law.
134

SEE ALSO

136       "livecd-iso-to-disk(8)", project website
137       <http://fedoraproject.org/wiki/FedoraLiveCD>
138
139
140
141livecd-tools 31.0                 2023-07-27                 LIVECD-CREATOR(8)
Impressum