fai-setup(8)

💖 fai-setup — bestie edition 💖

okay so this is the manual page for fai-setup(8) from the System Manager's Manual, and honestly? she's an icon. let's get into it ✨

---

✨ NAME ✨

fai-setup — the setup script for Fully Automatic Installation (FAI). that's her. that's the whole name. periodt 💅

---

🦋 SYNOPSIS 🦋

fai-setup

no args, no drama, just vibes. she knows what to do 🫶

---

🌸 DESCRIPTION 🌸

so Fully Automatic Installation (FAI) is this whole thing where you get unattended installation of Debian GNU/Linux operating systems, and it does it with a very flexible class-based system. it's giving "I set it up once and then I go touch grass while 200 machines install themselves." main character energy fr fr 😭

and like, what does fai-setup actually do? bestie, she:

• creates the initial NFSROOT directory 🎀
• creates the configuration space ✨
• sets up the NFS exports configuration file, which is /etc/exports 💅
• creates the initial fai user, the one that's used for copying the installation logs over to a centralized directory on the server 🫶

and then she calls fai-make-nfsroot(8) to actually create the initial NFS root directory. teamwork, babes 🤝

⭐ important bestie behaviour: you should call fai-setup after every single change to /etc/fai/fai.conf. every. single. one. no skipping, no "I'll do it later", no cap 💀

---

🔥 OPTIONS 🔥

first of all, an FYI: all options are also passed to fai-make-nfsroot. so everything you hand her, she hands along. sharing is caring 💖

• -C CFDIR — use CFDIR as the configuration directory. the default is /etc/fai. you can also set the environment variable FAI_ETC_DIR instead if that's more your vibe 🦋
• -e — Expert mode ✨. in this mode she will NOT add entries to /etc/export, she will NOT restart the nfs server, and she will NOT add anything to /var/log/fai/variables. like, she's just gonna mind her own business. respect 👑

---

👑 SEE ALSO 👑

this program is part of FAI (Fully Automatic Installation). if you wanna know more about how to actually use fai-setup, go read the FAI manual, bestie 📖

the FAI homepage is https://fai-project.org 🌈

• fai-make-nfsroot(8)
• exports(5)

---

🎀 FILES 🎀

• /etc/fai/fai.conf — the FAI configuration file. this is the one you keep editing, and the one you keep forgetting to re-run setup after 😭
• /etc/fai/nfsroot.conf — the configuration file for fai-make-nfsroot.
• /etc/exports — the NFS configuration file for exported filesystems.
• /var/log/fai/variables — the script will write the values of FAI_CONFIGDIR and FAI_CONFIG_SRC to this file ✍️

---

💜 AUTHOR 💜

Thomas Lange <lange@cs.uni-koeln.de>

---

and that's the whole page, bestie 🥹 this was FAI 3.2, dated 11 November April 2007 (yes, that's the date, don't look at me, I don't make the rules 💀), straight out of the System Manager's Manual. go run her, she slays 🫶✨💅