From eb261bae981f9d7856df13f1f64a3796ffea9363 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Wed, 24 Jan 2024 10:28:01 -0500 Subject: [PATCH] docs: Document `to-disk --via-loopback` Since it's super useful. Signed-off-by: Colin Walters --- docs/install.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/install.md b/docs/install.md index ef3e65c73..ef347f189 100644 --- a/docs/install.md +++ b/docs/install.md @@ -211,6 +211,19 @@ storage or filesystem setups, but reuses the "top half" of the logic. For example, a goal is to change [Anaconda](https://github.com/rhinstaller/anaconda/) to use this. +### Using `bootc install to-disk --via-loopback` + +Because every `bootc` system comes with an opinionated default installation +process, you can create a raw disk image (that can e.g. be booted via virtualization) +via e.g.: + +```bash +truncate -s 10G exampleos.raw +podman run --rm --privileged --pid=host --security-opt label=type:unconfined_t -v .:/output bootc install to-disk --generic-image --via-loopback /output/myimage.raw +``` + +Notice that we use `--generic-image` for this use case. + ### Using `bootc install to-filesystem --replace=alongside` This is a variant of `install to-filesystem`, which maximizes convenience for using