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

# mic-chroot(1)

chroot into a live image in order to do some changes

## NAME

mc-chroot - chroot into a live image in order to do some changes

## SYNOPSIS

mic-chroot \[options\] \<image\|image fs\>

\<image\> is a live image file name, \<image fs\> is a directory path which\
  contains the whole file system unpacked from a live image.

## DESCRIPTION

mic-chroot can chroot into a live image to do some changes, you can use it to unpack a live image then do some changes, once changes are done, you can regenerate a live image including those changes you did.

mic-image-manager has a GUI tool for mic-chroot, you can use it if you prefer to use GUI instead of command line.

## OPTIONS

**--version**                      show version number

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

**-s SAVETO, --save-to=SAVETO**    Save unpacked filesystem to the specified path

**--unpack-only**                  Just unpack an image, this is used tounpack an image with -s option together

**-b BINDMOUNTS, --bind-mounts=BINDMOUNTS**    Specify bind mount list, for example: -b "/proc:/proc;/:/parentroot"

**-c CONVERTTO, --convert-to=CONVERTTO**       Convert it to the specified type live image on exiting, the allowed value is livecd or liveusb

**--convert-only**                 Just convert an image, this will skip chroot and directly convert an image/filesytem with -c option together

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

## EXAMPLES

Unpack an image to a directory and chroot into it:

mic-chroot -s /my/fs/root

## EXIT STATUS

mic-image-convertor 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-creator*(1)](/mic-image-creator/1.md), *mic-convertor*(1), [*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)