install.site(5)

install.site5

Openbsd installation and upgrade customization

Overview

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

Releases

Unchanged in 11 releases since OpenBSD 7.1.

  1. 7.1–8.0

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's mdoc source.