Provisioning Fedora bootc locally with podman-bootc-cli

The podman-bootc-cli tool streamlines a local virtualization experience.

This command will "self-install" the container into a disk image behind the scenes, and launch an interactive SSH session.

$ podman-bootc run quay.io/centos-bootc/centos-bootc:stream9

Other useful commands include:

  • podman-bootc list

  • podman-bootc ssh

  • podman-bootc rm

The podman-bootc command can also directly run your custom derived container images! 
$ podman-bootc run quay.io/exampleuser/mycustom-image:latest

See Building derived container images.

Understanding authentication

The podman-bootc-cli tool streamlines logging into the generated disk images by injecting a default SSH key for the root user via systemd credentials passed to the hypervisor, and further automatically invoking ssh to get an interactive shell.

This maximizes convenience for testing locally, while supporting a container image that is intended to be deployed via e.g. Anaconda and e.g. a kickstart-provided SSH key to bare metal.

Or, you may be creating a container image that is intended to run via a fully "git-ops" fashion where it is not allowed to SSH in at all for production scenarios. This can be done by simply not including any SSH keys in your container image or disk image generation phases, but the podman-bootc CLI helps inject a key for local development/testing scenarios.

Want to help? Learn how to contribute to Fedora Docs ›