From Fedora Project Wiki


Build a simple generic network install image using lorax, and check it boots.


  1. Become root, with sudo su or su
  2. Install the Package-x-generic-16.pnglorax package version you wish to test, on a system with a decent amount of disk space available
  3. Create a working directory for the test (on a partition with a good amount of disk space free), e.g. mkdir -p /var/tmp/loraxtest, and cd to it
  4. Set SELinux to permissive mode, with setenforce Permissive

How to test

  1. Create the test image. The basic form of the command to run is lorax -p Fedora -v (version) -r (release) -s (repository URL) [-s (another repository URL)] ./results/
    • Always create an image for the same release and arch as you have installed!
    • You can usually use the release number for both -v and -r
    • If you have Fedora 39 x86_64 installed, you could run lorax -p Fedora -v 39 -r 39 -s -s ./results/
    • If you are testing lorax on a not-yet-stable release like Fedora 40, use the Everything repository from a Branched or Rawhide nightly compose (whichever one matches the release you're testing)
  2. If the command runs successfully, it will produce a network install image as results/images/boot.iso. Try booting this image as usual (e.g. by attaching it to a virtual machine, writing it to a USB stick, or writing it to an optical disc) and running a default installation

Expected Results

  1. The command should run successfully and produce a results/images/boot.iso file
  2. The image should boot and install successfully (assuming no underlying problems in the compose it is built from - if you run into a problem, check if the official Everything network install image from the compose you used has the same problem)