This repository contains all the instructions and code to build a Live ISO based on Fedora which can be used by podman-machine as an alternative to the Boot2podman ISO.

• Building the Fedora ISO
  • On Fedora
    • Prerequisites
    • Building the ISO
  • On hosts other than Fedora (OS X, Windows, CentOS ...)
    • Prerequisites
    • Building the ISO
  • Manual release
• Further reading
• Community

The following contains instructions on how to build the Fedora based ISO. If you are able to install livecd-tools directly on your machine, you can use the Fedora instructions.

If you don't have livecd-tools or using different linux distro other than Fedora, follow the hosts other than Fedora instructions.

• Update your system before start and if there is kernel update then reboot your system to activate latest kernel.

    $ dnf update -y
  

• Install livecd-tools

$ git clone https://github.com/boot2podman/boot2podman-fedora-iso.git
$ cd boot2podman-fedora-iso
$ make

• Vagrant

• vagrant-sshfs

    $ vagrant plugin install vagrant-sshfs
  

$ git clone https://github.com/boot2podman/boot2podman-fedora-iso.git
$ cd boot2podman-fedora-iso
$ vagrant up
$ vagrant ssh
$ cd <path to boot2podman-fedora-iso directory on the VM>/boot2podman-fedora-iso
$ make

The manual release includes following steps:

• Assemble all the meaningful changes since the last release to create release notes.

• Bump the VERSION variable in the Makefile.

• Before you execute below command be sure to have a Github personal access token defined in your environment as GITHUB_ACCESS_TOKEN.

• Run following command to perform release:

  $ make release

Setup your build environment by following the instructions provided in Building the Fedora ISO section as per your preferred OS.

Note: Building ISO might require you to have Vagrant environment if you are not using host other than Fedora.

Once you are able to build the ISO, you are most likely interested to modify the image itself. To do so you have to get familiar with pykickstart.

You can reach the Podman community by:

• Joining the #podman channel on Freenode IRC