bootc-install - Man Page

bootc install [-h|--help] <subcommands>

Install the running container to a target.

## Understanding installations

OCI containers are effectively layers of tarballs with JSON for metadata; they cannot be booted directly.  The `bootc install` flow is a highly opinionated method to take the contents of the container image and install it to a target block device (or an existing filesystem) in such a way that it can be booted.

For example, a Linux partition table and filesystem is used, and the bootloader and kernel embedded in the container image are also prepared.

A bootc installed container currently uses OSTree as a backend, and this sets it up such that a subsequent `bootc upgrade` can perform in-place updates.

An installation is not simply a copy of the container filesystem, but includes other setup and metadata.

-h,  --help

Print help (see a summary with '-h')

bootc-install-to-disk(8)

Install to the target block device

bootc-install-to-filesystem(8)

Install to an externally created filesystem structure

bootc-install-to-existing-root(8)

Install to the host root filesystem

bootc-install-finalize(8)

Execute this as the penultimate step of an installation using `install to-filesystem`

bootc-install-ensure-completion(8)

Intended for use in environments that are performing an ostree-based installation, not bootc

bootc-install-print-configuration(8)

Output JSON to stdout that contains the merged installation configuration as it may be relevant to calling processes using `install to-filesystem` that in particular want to discover the desired root filesystem type from the container image

bootc-install-help(8)

Print this message or the help of the given subcommand(s)

v1.1.7

bootc(8).