nfsroot.conf - nfsroot configuration for FAI
The nfsroot is a file system on the install server. It is used during
installation by the install clients.
defines the essential options for the install server, which
are mostly used inside the nfsroot. Use bash(1) syntax for defining variables.
- Two parameters for debootstrap(8), space separated.
Debootstrap is called as the first part of fai-make-nfsroot unless -B is
used. This variable defines SUITE and MIRROR for debootstrap. Example:
- This multiline variable is added to /etc/hosts inside the
nfsroot. You can use this when DNS is not available on the clients.
- The encrypted root password on all install clients during
the installation process. Used when log in via ssh. This is not the
password for the new installed system. Example:
FAI_ROOTPW='$1$kBnWcO.E$djxB128U7dMkrltJHPf6d1' # pw is fai
Use mkpasswd, htpasswd or md5pass for generating the password hash.
echo "yoursecrectpassword" | mkpasswd -Hmd5 -s
- Directory on the install server where the nfsroot is
- Directory on the install server for the tftp data, used by
PXE network boot.
- Location of the configuration space on the install server.
Used by fai-cd(8), fai-mirror(1) and fai-setup(8).
- Location of a ssh public key file. This user can log into
the install clients in as root without a password. Only useful with
- Directory of hooks to be sourced at the end of
fai-make-nfsroot, i.e. they have to be shell scripts.
- Options that will be passed to debootstrap(8). Used for
excluding packages and for specifying a different architecture.
Normally, the nfsroot is mounted by the install kernel via NFS. It's also used
on the FAI CD. FAI clients can also receive the nfsroot via http. There you
have to create a compressed squashfs image of the nfsroot with fai-cd(8).
This file is part of FAI (Fully Automatic Installation). The FAI homepage is
This man page was written by Thomas Lange