INSTALL.SITE(5) - File Formats Manual

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