No description
  • Python 45.5%
  • Shell 28.8%
  • Dockerfile 13.8%
  • Just 11.9%
Find a file
konflux d05dec8c3f Merge branch 'renovate/fedora-rawhide/fedora-rawhide-repos-image' into 'main'
Update Fedora Rawhide REPOS_IMAGE to Fedora-Rawhide-20260824.n.0

See merge request fedora/bootc/base-images!674
2026-08-24 20:52:01 +00:00
.tekton Update Fedora Rawhide REPOS_IMAGE to Fedora-Rawhide-20260824.n.0 2026-08-24 20:02:36 +00:00
ci ci: Add basic shellcheck, whitespace & format checks 2025-06-26 13:56:56 +02:00
eln eln: Ship 20-rhel.toml for RHEL-aligned bootc install defaults 2026-07-28 10:41:32 -04:00
fedora-includes Add fedora-eln manifest for centos-eln 2026-07-24 14:23:05 -04:00
finalize.d Install bootc-base-imagectl in Pungi path 2025-06-09 13:51:00 -04:00
iot whitespace changes to appease downstream CI 2025-05-09 12:52:16 -04:00
minimal Add a dependency on dbus to make systemd work 2026-07-27 11:36:15 +02:00
minimal-plus Rename tier-x → minimal-plus 2025-03-18 10:12:38 -04:00
standard standard: Move clevis-pin-tpm2 to arch-specific packages 2026-07-28 14:51:19 -04:00
tests minimal: Add tmpfiles entries for Konflux injected content 2026-06-01 17:11:35 -04:00
.gitlab-ci.yml .gitlab-ci.yml: bump Just version pin 2026-04-08 16:20:48 -04:00
.mdl_style.rb Update .mdl_style.rb 2023-11-09 16:14:45 +02:00
.mdlrc Update .mdlrc 2023-11-09 16:18:33 +02:00
.pre-commit-config.yaml chore(deps): update all dependencies 2026-01-09 15:08:46 +00:00
bootc-base-imagectl bootc-base-imagectl: error when --add-dir dir is missing 2026-06-22 13:37:09 -04:00
bootc-base-imagectl.md bootc-base-imagectl/rechunk: add --chunkah mode 2026-04-02 13:21:24 -04:00
Containerfile Containerfile: add chunked build target 2026-04-02 13:22:44 -04:00
CONTRIBUTING.md Containerfile: add chunked build target 2026-04-02 13:22:44 -04:00
COPYING Enable pre-commit 2023-10-30 22:27:12 +02:00
eln.yaml made it a symlink instead of a hard link 2026-07-24 14:23:06 -04:00
fedora-41.yaml Remove releasever from manifests; add pungi treefile stubs 2024-10-23 15:27:50 -04:00
fedora-43.yaml chore: update fedora-43 repo url to final 2025-10-29 08:44:31 -04:00
fedora-44.yaml chore: add fedora-44.yaml for branching 2026-02-06 11:41:05 -05:00
fedora-bootc-config.json Only rawhide 2024-05-28 19:53:56 +03:00
fedora-bootc.yaml Swap symlink state for fedora-bootc -> fedora-standard 2025-02-25 08:27:20 -05:00
fedora-eln.yaml removed whitespace 2026-07-24 14:23:06 -04:00
fedora-iot.yaml Drop fedora- prefix from canonical manifests 2025-06-17 15:32:25 -04:00
fedora-minimal-plus.yaml bootc-base-imagectl: support hidden manifests, hide minimal-plus 2025-06-17 15:46:08 -04:00
fedora-minimal.yaml Drop fedora- prefix from canonical manifests 2025-06-17 15:32:25 -04:00
fedora-rawhide.yaml Remove releasever from manifests; add pungi treefile stubs 2024-10-23 15:27:50 -04:00
fedora-standard.yaml Drop fedora- prefix from canonical manifests 2025-06-17 15:32:25 -04:00
fedora.repo fedora.repo: Drop trailing whitespace 2024-04-18 16:33:36 -04:00
install-manifests install-manifests: Handle ELN as rawhide-only variant 2026-07-24 14:23:06 -04:00
iot.yaml Drop fedora- prefix from canonical manifests 2025-06-17 15:32:25 -04:00
Justfile Containerfile: add chunked build target 2026-04-02 13:22:44 -04:00
LICENSE Initial split from Fedora CoreOS 2022-12-09 15:32:25 -05:00
minimal-plus.hidden.yaml bootc-base-imagectl: support hidden manifests, hide minimal-plus 2025-06-17 15:46:08 -04:00
minimal.yaml Drop fedora- prefix from canonical manifests 2025-06-17 15:32:25 -04:00
README.md Switch ELN from minimal-plus to standard tier 2026-07-24 14:23:06 -04:00
RELEASE.md docs: address MR feedback and simplify RELEASE.md 2026-02-17 12:09:40 +01:00
renovate.json Add Konflux pipeline for Fedora ELN (fedora-eln minimal-plus) 2026-07-24 14:23:06 -04:00
standard.yaml standard: move chunkah to fedora-only manifest 2026-04-20 15:37:22 -04:00

Fedora bootc base images

Create and maintain base bootable container images from Fedora packages.

Motivation

The original Docker container model of using "layers" to model applications has been extremely successful. This project aims to apply the same technique for bootable host systems - using standard OCI/Docker containers as a transport and delivery format for base operating system updates.

Building images

The current default user experience is to build layered images on top of the official binary base images produced and tested by this project. See the documentation5 for more info.

If you want total control over the image, you don't need to fork this repository. Instead, you can use the existing container as a "builder" to make new images. For more information, see the documentation6.

Contributing

See CONTRIBUTING.md for the full development workflow.

Fedora versions

By default, the base images are built for Fedora rawhide. To build against a different Fedora version:

FEDORA_VERSION=43 just build

Content sets/tiers

Documentation above referenced the scratch6 flow, but there is also a minimal-plus that is not exposed as a stable interface, but may be used by other images in Fedora.

  • standard: This image is the default, what is published as https://quay.io/repository/fedora/fedora-bootc
  • minimal: This content set is more of a convenient centralization point for CI and curation around a package set that is intended as a starting point for a container base image.
  • minimal-plus: This content set is intended to be the shared base used by all image-based Fedora variants (IoT, Atomic Desktops, and CoreOS).

standard inherits from minimal-plus and minimal-plus in turn inherit from minimal.

  • eln (manifest fedora-eln): Standard base image for Enterprise Linux Next (ELN). Uses distro fedora and inherits from standard; built with ELN repos. The image produced by this manifest is published as fedora-eln.

All non-trivial changes to minimal and minimal-plus should be ACKed by at least one stakeholder of each Fedora variant WGs.

Available Tiers + Versions

NOTE: The location and naming of these images is subject to change.

Version standard minimal minimal-plus
Rawhide quay.io/bootc-devel/fedora-bootc-rawhide-standard quay.io/bootc-devel/fedora-bootc-rawhide-minimal quay.io/bootc-devel/fedora-bootc-rawhide-minimal-plus
Fedora 43 quay.io/bootc-devel/fedora-bootc-43-standard quay.io/bootc-devel/fedora-bootc-43-minimal quay.io/bootc-devel/fedora-bootc-43-minimal-plus

More information

Documentation: https://docs.fedoraproject.org/en-US/bootc/

Badges

Badge Description Service
Renovate Dependencies Renovate
Pre-commit Static quality gates pre-commit