NAME
bootc-install - Install the running container to a target
SYNOPSIS
bootc install [OPTIONS...] <SUBCOMMAND>
DESCRIPTION
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.
SUBCOMMANDS
| Command | Description |
|---|---|
| bootc install to-disk | Install to the target block device |
| bootc install to-filesystem | Install to an externally created filesystem structure |
| bootc install to-existing-root | Install to the host root filesystem |
| bootc install finalize | Execute this as the penultimate step of an installation using install to-filesystem |
| bootc install ensure-completion | Intended for use in environments that are performing an ostree-based installation, not bootc |
| bootc install print-configuration | 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 |
VERSION
The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.