Skip to content

Commit 5fe22e6

Browse files
committed
docs: adds information regarding using bootc extension offline
### What does this PR do? Adds some information on how to use bootc while offline, specifically how to download any and all required images in order to use it. ### Screenshot / video of UI <!-- If this PR is changing UI, please include screenshots or screencasts showing the difference --> N/A, documentation. ### What issues does this PR fix or reference? <!-- Include any related issues from Podman Desktop repository (or from another issue tracker). --> Part of #2098 ### How to test this PR? Read through the docs! :) Pull the images, turn yourself offline, and then run / try to build them. <!-- Please explain steps to reproduce --> Signed-off-by: Charlie Drage <[email protected]>
1 parent 51d0426 commit 5fe22e6

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed

README.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ Easily go from container to VM / ISO-on-a-USB / RAW image!
1616
- [Advanced Usage](#advanced-usage)
1717
- [Preferences](#preferences)
1818
- [Known Issues](#known-issues)
19+
- [Offline / Airplane Mode](#offline--airplane-mode)
1920
- [Contributing](#contributing)
2021

2122
## Technology
@@ -256,6 +257,77 @@ Follow the below steps for the solution:
256257
3. `sudo mkdir /usr/libexec/podman`
257258
4. `sudo mv gvproxy-linux-amd64 /usr/libexec/podman/gvproxy`
258259

260+
## Offline / airplane mode
261+
262+
Planning to build disk images on an airplane, train, or somewhere with slow/no internet? You can pre-download all the required container images needed to run the bootc extension beforehand.
263+
264+
**Note:** ISO builds (`anaconda-iso`) will **not** work offline as they pull RPMs during the build process. Use `qcow2`, `raw`, `vmdk`, `vhd`, or other formats for offline builds.
265+
266+
### Pre-pulling the bootc-image-builder (BIB) images
267+
268+
The extension uses `bootc-image-builder` to create disk images. Pull the appropriate builder for your base image:
269+
270+
```sh
271+
# CentOS builder (default)
272+
podman pull quay.io/centos-bootc/bootc-image-builder:sha256-c2d6830647c095e29c8cabd1ef6ae0e903e77675b953655428ac5cef147541a0
273+
274+
# RHEL 9 builder (requires Red Hat subscription)
275+
podman pull registry.redhat.io/rhel9/bootc-image-builder:9.7
276+
277+
# RHEL 10 builder (requires Red Hat subscription)
278+
podman pull registry.redhat.io/rhel10/bootc-image-builder:10.1
279+
```
280+
281+
### Pre-pulling example images
282+
283+
The extension dashboard shows example images you can use. You can pre-pull these as well:
284+
285+
```sh
286+
# Apache httpd web server
287+
podman pull registry.gitlab.com/fedora/bootc/examples/httpd:latest
288+
289+
# Tailscale VPN
290+
podman pull registry.gitlab.com/fedora/bootc/examples/tailscale:latest
291+
292+
# Podman systemd (container managed by systemd)
293+
podman pull registry.gitlab.com/fedora/bootc/examples/app-podman-systemd:latest
294+
295+
# QEMU guest agent
296+
podman pull registry.gitlab.com/fedora/bootc/examples/qemu-guest-agent:latest
297+
298+
# WiFi modules
299+
podman pull registry.gitlab.com/fedora/bootc/examples/wifi:latest
300+
301+
# Kernel module management
302+
podman pull registry.gitlab.com/fedora/bootc/examples/kernel-module:latest
303+
```
304+
305+
### Pre-pulling base bootc images
306+
307+
You can also pre-pull the base image(s) you plan to build your own Containerfile's offline.
308+
309+
```sh
310+
# CentOS
311+
podman pull quay.io/centos-bootc/centos-bootc:stream9
312+
podman pull quay.io/centos-bootc/centos-bootc:stream10
313+
314+
# Fedora
315+
podman pull quay.io/fedora/fedora-bootc:42
316+
podman pull quay.io/fedora/fedora-bootc:43
317+
podman pull quay.io/fedora/fedora-bootc:44
318+
319+
# RHEL (requires Red Hat subscription)
320+
podman pull registry.redhat.io/rhel9/rhel-bootc:latest
321+
podman pull registry.redhat.io/rhel10/rhel-bootc:latest
322+
```
323+
324+
### Example workflow for offline use
325+
326+
1. While online, pull the builder and base images you need
327+
2. Build your bootc container image from your Containerfile
328+
3. Go offline
329+
4. Use the extension to build disk images (qcow2, raw, vmdk, etc.)
330+
259331
## Contributing
260332

261333
Want to help develop and contribute to the bootc extension? View our [CONTRIBUTING](https://github.com/containers/podman-desktop-extension-bootc/blob/main/CONTRIBUTING.md) document.

0 commit comments

Comments
 (0)