Skip to content

docs: adds information regarding using bootc extension offline #2129

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cdrage merged 1 commit into from
Dec 9, 2025
+72 −0
Merged

docs: adds information regarding using bootc extension offline #2129

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Easily go from container to VM / ISO-on-a-USB / RAW image!
- [Advanced Usage](#advanced-usage)
- [Preferences](#preferences)
- [Known Issues](#known-issues)
- [Offline / Airplane Mode](#offline--airplane-mode)
- [Contributing](#contributing)

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

## Offline / airplane mode

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.

**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.

### Pre-pulling the bootc-image-builder (BIB) images

The extension uses `bootc-image-builder` to create disk images. Pull the appropriate builder for your base image:

```sh
# CentOS builder (default)
podman pull quay.io/centos-bootc/bootc-image-builder:sha256-c2d6830647c095e29c8cabd1ef6ae0e903e77675b953655428ac5cef147541a0

# RHEL 9 builder (requires Red Hat subscription)
podman pull registry.redhat.io/rhel9/bootc-image-builder:9.7

# RHEL 10 builder (requires Red Hat subscription)
podman pull registry.redhat.io/rhel10/bootc-image-builder:10.1
```

### Pre-pulling example images

The extension dashboard shows example images you can use. You can pre-pull these as well:

```sh
# Apache httpd web server
podman pull registry.gitlab.com/fedora/bootc/examples/httpd:latest

# Tailscale VPN
podman pull registry.gitlab.com/fedora/bootc/examples/tailscale:latest

# Podman systemd (container managed by systemd)
podman pull registry.gitlab.com/fedora/bootc/examples/app-podman-systemd:latest

# QEMU guest agent
podman pull registry.gitlab.com/fedora/bootc/examples/qemu-guest-agent:latest

# WiFi modules
podman pull registry.gitlab.com/fedora/bootc/examples/wifi:latest

# Kernel module management
podman pull registry.gitlab.com/fedora/bootc/examples/kernel-module:latest
```

### Pre-pulling base bootc images

You can also pre-pull the base image(s) you plan to build your own Containerfile's offline.
Copy link

@coderabbitai coderabbitai bot Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix grammar error: remove possessive apostrophe and clarify sentence.

Line 307 uses an incorrect possessive apostrophe and the sentence structure is awkward. The phrase "build your own Containerfile's offline" should be clarified.

Apply this diff:

-You can also pre-pull the base image(s) you plan to build your own Containerfile's offline.
+You can also pre-pull the base image(s) you plan to use for your own Containerfile offline.

Also applies to: 307-307

🤖 Prompt for AI Agents 
In README.md around line 307, the sentence incorrectly uses a possessive
apostrophe ("Containerfile's") and reads awkwardly; remove the possessive and
rephrase to clarify intent, e.g., change the line to something like: "You can
also pre-pull the base image(s) you plan to use when building your Containerfile
so you can build offline." Make sure the updated sentence removes the
apostrophe, uses "use when building" (or similar wording) for clarity, and
preserves the note about pre-pulling images for offline builds.


```sh
# CentOS
podman pull quay.io/centos-bootc/centos-bootc:stream9
podman pull quay.io/centos-bootc/centos-bootc:stream10

# Fedora
podman pull quay.io/fedora/fedora-bootc:42
podman pull quay.io/fedora/fedora-bootc:43
podman pull quay.io/fedora/fedora-bootc:44

# RHEL (requires Red Hat subscription)
podman pull registry.redhat.io/rhel9/rhel-bootc:latest
podman pull registry.redhat.io/rhel10/rhel-bootc:latest
```
Comment on lines +305 to +322
Copy link

@coderabbitai coderabbitai bot Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix grammar error: remove possessive apostrophe on line 307.

Line 307 uses possessive "'s" incorrectly in "Containerfile's offline." Should be "Containerfile" without the possessive apostrophe.

Apply this diff to fix the grammar:

-You can also pre-pull the base image(s) you plan to build your own Containerfile's offline.
+You can also pre-pull the base image(s) you plan to use for your own Containerfile offline.

The base image references (CentOS, Fedora, RHEL) are comprehensive and accurate.

🧰 Tools
🪛 LanguageTool

[grammar] ~305-~305: Ensure spelling is correct
Context: ...module:latest ``` ### Pre-pulling base bootc images You can also pre-pull the base ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🤖 Prompt for AI Agents 
In README.md around lines 305 to 322, remove the incorrect possessive apostrophe
on line 307 by changing "Containerfile's offline" to "Containerfile offline"
(i.e., delete the apostrophe), then save the file.


### Example workflow for offline use

1. While online, pull the builder and base images you need
2. Build your bootc container image from your Containerfile
3. Go offline
4. Use the extension to build disk images (qcow2, raw, vmdk, etc.)

## Contributing

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.