NAME

installiso — Customize OpenBSD installation images

SYNOPSIS

DESCRIPTION

The installiso utility facilitates creating custom ISO 9660 installation images for the unattended installation of OpenBSD.

The common options are as follows:

-v

Verbose mode. Causes installiso to print informative messages. Multiple -v options increase the verbosity. The maximum is 2. By default, installiso is quiet.

The commands are as follows:

fetch [-f] [-m mirror] [-r release] [-p key] [-o output]

Download and verify an official ISO 9660 installation image.

-f

Force overwriting existing files. By default, fetch will not overwrite existing files.

-m mirror

The HTTP(S) OpenBSD mirror to use. Defaults to the mirror specified by installurl(5) or else https://cdn.openbsd.org/pub/OpenBSD/.

-r release

The OpenBSD release. Defaults to the latest development snapshot of -current.

-p key

The public signify(1) key used to verify the downloaded installation image. Defaults to the key /etc/signify/openbsd-*-base.pub corresponding to the downloaded release.

patch [-f] [-i install_conf] [-u upgrade_conf] [-s site_dir] input output

Patch an ISO 9660 installation image.

-f

Force overwriting existing files. By default, patch will not overwrite existing files.

-i install_conf

Insert an autoinstall(8) response file for unattended installation.

-u upgrade_conf

Insert an autoinstall(8) response file for unattended upgrade.

-s site

Package and insert the directory site as a site-specific file set.

input

The input installation image file.

output

The output installation image file.

EXIT STATUS

The installiso utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

Fetch the latest development snapshot:

$ installiso -v fetch

Fetch a specific release:

$ installiso -v fetch -r 6.9

Create a custom image for unattended installation:

$ doas installiso -v patch -i install.conf install69.iso custom.iso

SEE ALSO

autoinstall(8), mkhybrid(8), rdsetroot(8), sysupgrade(8), vnconfig(8)

AUTHORS

Stefan Kreutz <mail@skreutz.com>

BUGS

The installiso utility is currently limited to the amd64 architecture because it wasn't tested on any other architecture.