INSTALL.SITE(5) - File Formats Manual #
INSTALL.SITE(5) - File Formats Manual
NAME #
install.site, upgrade.site - OpenBSD installation and upgrade customization
DESCRIPTION #
The OpenBSD installer allows user-created sets and scripts to complement and modify the files from a default install prior to rebooting.
Like the official file sets, 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.
siteXY sets must be included in index.txt in order to be fetched via HTTP(S) and selectable in the installer.
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.
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)
OpenBSD 7.5 - November 8, 2021