INSTALL.SITE(5)

💖 NAME 💖

okay bestie, this is INSTALL.SITE(5), a File Formats Manual page, and she is all about install.site, upgrade.site — OpenBSD installation and upgrade customization. 🦋

✨ DESCRIPTION ✨

so the OpenBSD installer literally allows user-created sets and scripts to complement and modify the files from a default install prior to rebooting. it's giving "bring your own sparkle" 💅

Like the official file sets, the generic site${VERSION}.tgz and hostname-specific site${VERSION}-$(hostname -s).tgz sets are gzip(1) compressed tar(1) archives rooted in / and untarred with the -xzphf options. no cap.

siteXY sets must be included in index.txt in order to be fetched via HTTP(S) and selectable in the installer. iykyk 👑

If they exist and are executable, /install.site and /upgrade.site are run at the end of the install and upgrade process, respectively, with chroot(8) based at the system's root. periodt. 🔥

🎀 FILES 🎀

• site${VERSION}.tgz — Generic set.
• site${VERSION}-$(hostname -s).tgz — Host-specific set.
• /upgrade.site — Generic post-upgrade script.
• /install.site — Generic post-install script.

🌸 EXAMPLES 🌸

Create site70 sets and update the index:

# tar -czhf site70.tgz generic/
# tar -czhf site70-puffy.tgz puffy/
# ls -lT > index.txt

Upgrade packages(7) upon reboot after sysupgrade(8) upgraded the system:

# cat <<- EOF >> /upgrade.site
        echo 'pkg_add -Iu' >>/etc/rc.firsttime
EOF
# chmod +x /upgrade.site
# sysupgrade

🌈 SEE ALSO 🌈

• autoinstall(8)
• rc(8)
• sysupgrade(8)

---

source/version: Debian · date: November 8, 2021 — that's the whole page, bestie, mwah 💋🫶