Skip to content

Commit eb261ba

Browse files
committed
docs: Document to-disk --via-loopback
Since it's super useful. Signed-off-by: Colin Walters <[email protected]>
1 parent b62f6a5 commit eb261ba

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

docs/install.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,19 @@ storage or filesystem setups, but reuses the "top half" of the logic.
211211
For example, a goal is to change [Anaconda](https://github.com/rhinstaller/anaconda/)
212212
to use this.
213213

214+
### Using `bootc install to-disk --via-loopback`
215+
216+
Because every `bootc` system comes with an opinionated default installation
217+
process, you can create a raw disk image (that can e.g. be booted via virtualization)
218+
via e.g.:
219+
220+
```bash
221+
truncate -s 10G exampleos.raw
222+
podman run --rm --privileged --pid=host --security-opt label=type:unconfined_t -v .:/output <yourimage> bootc install to-disk --generic-image --via-loopback /output/myimage.raw
223+
```
224+
225+
Notice that we use `--generic-image` for this use case.
226+
214227
### Using `bootc install to-filesystem --replace=alongside`
215228

216229
This is a variant of `install to-filesystem`, which maximizes convenience for using

0 commit comments

Comments
 (0)