---
name: "mic-image-creator"
section: "1"
platform: "linux"
package: "mic2"
version: "0.24.12-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/mic-image-creator"
---

# mic-image-creator(1)

Create various images

## NAME

mic-image-creator -  Create various images

## SYNOPSIS

mic-image-creator \[options\]

## DESCRIPTION

mic-image-creator is a powerful image creating tool, it can create live CD, live USB, VMWare, KVM and VirtualBox images using a yum repository and a kickstart file.

There are also many companion tools for doing various operations on images, including mic-image-convertor, mic-chroot, mic-image-writer, mic-livecd-iso-to-disk, etc. They are all command line tools except mic-image-writer which has GUI if current runtime environment is X. mic-image-manager is a more powerful GUI toolset for them.

## OPTIONS

General options:

**--version**                        show version number and exit

**-h, --help**                       show this help message and exit

**-c KSCFG, --config=KSCFG**          Path to kickstart config file

**-f FORMAT, --format=FORMAT**        Image format, you can specify as livecd, liveusb, loop, raw, nand, mrstnand, ubi, vdi or vmdk

**-t TMPDIR, --tmpdir=TMPDIR**        Temporary directory to use (default: /var/tmp)

**-k CACHEDIR, --cache=CACHEDIR**     Cache directory to use (default: private cache)

**-o OUTDIR, --outdir=OUTDIR**        Output directory to use (default: current work dir)

**--genchecksum**                     Generate checksum for image file if this option is provided

**-S SUFFIX, --suffix=SUFFIX**        Image name suffix (default: date stamp)

**-b, --build-bootstrap**             Build a bootstrap, it should be used with -B or --bootstrap together

**--mainrepo=MAINREPO**               Specify main repo name, it must be a repo name in your kickstart file

**--siteconf=SITECONF**               Specify site config file, it can be used to set tmpdir, cachedir, outputdir, it also can be used to remap/reroute a repo in kickstart to another equivalent repo, the default site config is ~/.mic2\_site.conf.

**--repo=REPO**                       Specify additional repo, it may be a simple URL or a complicated tuple string, you can specify multiple repos using this option multiple times

**-B BOOTSTRAP, --bootstrap=BOOTSTRAP**    Use a given bootstrap env to create image

**--alt-initrd-name=ALT\_INITRD\_NAME**  Name of alternate initrd image, if NOT to use the one from kernel package

**--record-pkgs=RECORD\_PKGS**          Record the installed packages, valid values: name, content

**--local-pkgs-path=LOCAL\_PKGS\_PATH**  Path for local pkgs (rpms) to be installed

## OPTIONS For Live USB

These options are for creating the live USB file image

**-i, --interactive**                  Directly write into a USB disk.

**--fstype=FSTYPE**                    File system type for live USB file image, ext3 or vfat, the default is vfat.

**--overlay-size-mb=OVERLAYSIZEMB**    overlay size in MB as unit, it means how size changes you can save in your live USB disk.

## OPTIONS for MRST NAND

These options are for creating the MRST NAND image

**--initrd-url=INITRD\_URL**            URL of initrd.img, if it need to be retrieved from remote site.

**--initrd-path=INITRD\_PATH**          Path of initrd.img, if it was saved in local filesystem.

**--kernel-url=KERNEL\_URL**            URL of kernel file(vmlinuz), if it need to be retrieved from remote site.

**--kernel-path=KERNEL\_PATH**          Path of kernel file(vmlinuz), if it was saved in local filesystem.

**--kernel-rpm-url=KERNEL\_RPM\_URL**    URL of kernel rpm package, if it need to be retrieved from remote site.

**--kernel-rpm-path=KERNEL\_RPM\_PATH**  Path of kernel rpm package, if it was saved in local filesystem.

**--bootimg-only**      Create boot image only.

## OPTIONS For Debug

These options control the output of logging information during image creation

**-d, --debug**         Output debugging information

**-v, --verbose**       Output verbose progress information

**--logfile=FILE**      Save debug information to FILE

## EXAMPLES

Create a live CD image:

mic-image-creator -f livecd -c 2.1-final.ks

## EXIT STATUS

mic-image-creator returns  a  zero  exist  status  if it succeeds, otherwise return non-zero and print error message.

## AUTHOR

Yi Yang, Anas Nashif, Jianfeng Ding

## SEE ALSO

[*mic-image-convertor*(1)](/mic-image-convertor/1.md), [*mic-chroot*(1)](/mic-chroot/1.md), [*mic-image-writer*(1)](/mic-image-writer/1.md), [*mic-livecd-iso-to-disk*(1)](/mic-livecd-iso-to-disk/1.md), *mic-image-manager*(1)