pragmatism first

FAI-MAKE-NFSROOT(8) - Linux manual page online | Administration and privileged commands

Create the FAI nfsroot directory.

April 2015
fai-make-nfsroot(8) System Manager's Manual fai-make-nfsroot(8)


fai-make-nfsroot - create the FAI nfsroot directory


fai-make-nfsroot [options]


Create the FAI nfsroot directory as pointed by $NFSROOT in the config_file. This direc‐ tory is necessary for the installation of Debian on remote clients using the FAI package. The config_file location is discussed in the OPTIONS below. The exit code returned is 0 if all commands to build the root directory exited success‐ fully and >0 if an error occurs.


-a Adjust a generic nfsroot. Add resolv.conf, add host entries, set the root password. -B BASETGZ Use specified BASETGZ file as base.tgz (or base.tar.gz, base.tar.xz, base.txz) for the nfsroot. This avoids calling debootstrap and therefore reduces the buildtime for the nfsroot. -C CFDIR Use CFDIR as configuration directory. Default is /etc/fai. You can also set the environment variable FAI_ETC_DIR. -f Force overwriting an existing nfsroot. By default fai-make-nfsroot aborts if the configuration variable NFSROOT points to a directory which already exists. To force overwriting (and therefore rebuilding) the existing nfsroot use this option. This option is supported starting with FAI 4.0. Note: To update and therefore preserve an existing nfsroot see option -k. -g Create a generic nfsroot. Remove most install server specific data from nfsroot. See also -a. -K Remove all kernels from NFSROOT. This is the same as calling aptitude purge ~nlinux-image inside the nfsroot. -k Install additional packages defined in /etc/fai/NFSROOT into the nfsroot. Also copies all kernels from the nfsroot to the directory $TFTPROOT. -p Preserve ssh configs including the keys of the root account. This will not preserve the ssh host keys inside the nfsroot. -v Create verbose output on stdout. -h Show simple help. -z Use gzip for compressing the base.tar file. Default is to use xz.


If you do not use NFS, you may still use the NFSROOT directory as a staging point for building the base installation tarball.


exports(5), nfsd(8), fai-setup(8) This program is part of FAI (Fully Automatic Installation). See the FAI manual for more information on how to use fai-make-nfsroot. The FAI homepage is


/etc/fai/fai.conf The FAI configuration file. /etc/fai/nfsroot.conf The configuration file for fai-make-nfsroot. /etc/fai/nfsroot-hooks/ Directory containing shell scripts to be sourced at the end of fai-make-nfsroot for additional configuration of the nfsroot. Can be changed with NFSROOT_HOOKS. /etc/fai/apt/sources.list Copy this file to the NFSROOT. /etc/fai/apt/keys/*.asc Repository keys in .asc format found here will be installed into the NFSROOT. /var/log/fai/variables The script will write the values of FAI_VERSION and NFSROOT to this file.


Thomas Lange <>
FAI 5 April 2015 fai-make-nfsroot(8)
This manual Reference Other manuals
fai-make-nfsroot(8) referred by fai-mirror(1) | fai-setup(8) | fai.conf(5) | nfsroot.conf(5)
refer to exports(5) | fai-setup(8) | nfsd(8)
Download raw manual
Index System Manager's Manual (+2060) FAI 5 (+3) № 8 (+5755)
Go top