Man Linux: Main Page and Category List


       fai-cd - make a bootable CD-ROM or USB stick that performs an FAI


       fai-cd [OPTION] -m MIRROR FILE
       fai-cd [OPTION] -m MIRROR -u DIRECTORY
       fai-cd [OPTION] -B FILE


       This  command  creates  a  bootable  ISO CD-ROM image that performs the
       fully automatic installation from CD-ROM without an install server. The
       ISO  image  will  be  written to FILE. To create the image, the command
       needs the NFSROOT, the configuration space and a partial mirror,  which
       is  created by fai-mirror. The command can also copy all needed data to
       DIRECTORY on a mounted USB stick.


       -B     Create a boot only ISO image which does a network  installation.
              It  does  not  the  nfsroot, the partitial mirror and the config
              space. Unless the option  -g  is  used,  /usr/share/fai/menu.lst
              will be used as boot menu configuration.

       -b     After creating the ISO image burn it by calling cdrecord(1).

       -C CFDIR
              Use  CFDIR  as the configuration directory. Default is /etc/fai.
              You can also set the environment variable FAI_ETC_DIR.

       -f     Force removal of an existing ISO image  before  creating  a  new

       -G INTEGER
              Use  INTEGER as version number for grub boot loader. By default,
              grub2 (grub-pc) is used. fai-cd tries to  find  the  named  grub
              version  in  NFSROOT first. If this version is not installed, it
              downloads the appropriate grub  package  and  uses  these  files
              without acutally installing it.

       -g FILE
              Use  FILE  as  grub grub.cfg/menu.lst file. The script will look
              for FILE in CFDIR. If FILE is located in another directory  then
              a   full   path   must  be  specified.  If  not  specified,  use
              /etc/fai/grub.cfg for grub2 or /etc/fai/menu.lst for grub1.

              Specify which grub version should be used. Either 1  or  2,  the
              default is 2.

       -h     Show simple help and version.

       -H     Do  not  hide  directories. Using this option will consume 220MB
              more disk space on your media. By default, some directories like
              man pages and locales are hidden and will not be put onto the CD
              or the USB stick.

       -k     Keep the temporary filesystem for  debugging.  The  script  will
              sleep  for  a  long  time, before continuing the cleanup of temp
              files and mounts. Beware of killing  or  suspending  the  script
              itself, since a lot of mounts will remain. This is for debugging

       -m DIRECTORY
              Use DIRECTORY as partial FAI mirror. This option is mandatory.

       -n     No ISO image. Do not call mkisofs to create the ISO image.  This
              is  for creating the filesystem only. Useful for writing it to a
              USB stick.

       -u DIRECTORY
              Create a bootable USB stick. The USB stick must  be  mounted  on
              DIRECTORY  before  you  run  fai-cd.  Copies  all FAI-CD data to
              DIRECTORY and try to install grub onto its device. Currently the
              file  system  on  the  USB stick must be ext2. USUALLY THIS WILL


       After you've created a mirror with fai-mirror in /media/mirror, you can
       create a CD using:

          # fai-cd -m /media/mirror fai-cd.iso

       If  you want to create a bootable USB stick, create an ext2 file system
       on your stick, mount it to /media/usbstick and call

          # fai-cd -m /media/mirror -u /media/usbstick
          # umount /media/usbstick


       This program is part of FAI (Fully Automatic  Installation).   The  FAI
       homepage is



              The FAI configuration file.
              The default grub2 menu configuration file for fai-cd.
              The default grub1 menu configuration file for fai-cd.
              The default grub2 menu configuration file when using -B.
              The default grub1 menu configuration file when using -B.


       Thomas Lange <>