livecd-creator - Man Page

creates live CD or DVD images.


livecd-creator [Options]


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


-h,  --help

Shows the help message and exits.

Image Options

These options define the created image.

-c KSCFG, --config=KSCFG

Path to kickstart configuration file.

-b BASE_ON, --base-on=BASE_ON

Add packages to an existing live CD iso9660 image.

-f FS_LABEL, --fslabel=FS_LABEL

Defines the file system label. The default is based on the configuration name.


Title used by syslinux.cfg file.


Product name used in syslinux.cfg boot stanzas and countdown.

-p,  --plugins

Use DNF plugins during image creation.


Specify a compressor recognized by mksquashfs. xz is the default and works with 2.6.38 and later kernels. gzip works with all kernels. lzo works with 2.6.36 and later kernels. lzma will only work with custom kernels. xz1m is interpreted as "xz -b 1M -Xdict-size 1M -norecovery". Set to None to force reading the compressor used in BASE_ON. If gzip is used, the -comp option is not passed to mksquashfs to allow the use of older versions of mksquashfs. Multiple arguments should be specified in one string, i.e., --compression-type "type arg1 arg2 ...".


Set the value to substitute for $releasever in kickstart repo urls.

System Directory Options

These options define directories used on your system for creating the live image.

-t TMPDIR, --tmpdir=TMPDIR

defines the temporary directory to use. The default directory is /var/tmp.


Defines the cache directory to use (default: private cache).


Work offline from cache, use together with --cache (default: False).


Skip cleanup of temporary files.

Debugging Options

These options control the output of logging information during image creation.

-d,  --debug

Output debugging information.

-v,  --verbose

Output verbose progress information.

-q,  --quiet

Supress stdout.


Save debug information to FILE.


Barebones LiveCD

livecd-creator \ --config=/usr/share/livecd-tools/livecd-fedora-minimal.ks

Fedora Desktop Live CD

livecd-creator \ --config=/usr/share/livecd-tools/livecd-fedora-desktop.ks \ --fslabel=Fedora9-LiveCD-foo

Repo Extensions

livecd-creator provides for some extensions to the repo commands similar to what DNF supports. The strings $arch, $basearch and $releasever are replaced with the system arch, basearch and release version respectively. When no --releasever is passed it defaults to the current system's version. This allows the use of repo commands such as the following:

repo --name=fedora --mirrorlist=$releasever&arch=$basearch

Note that in a chroot environment (like koji) the rpmdb is not available, so either don't use $releasever in that case, or pass --releasever=VER.


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


Report bugs to the mailing list <> or directly to Bugzilla <> against the Fedora product, and the livecd-tools component.

See Also

livecd-iso-to-disk(8), project website <>

Referenced By

livecd-iso-to-disk(8), mkbiarch(8), virt-p2v-make-kickstart(1).

2024-01-25 livecd-tools 31.0 LiveCD Tools