How to build the official style iso image?

What is the process used to build the official iso images?

I found live-server.yaml, but the official
images seem to have some additional boot loader (which also allows to edit the kernel boot options on boot time.

You might be able to use the link shown:
url:Index of /releases/ (
to see how previous and current releases are put together.

You mean the boot timeout?
Follow the rabbit trail: live-server.yaml → →

@btwarden hi, thx for picking it up. Trust me, I am chasing rabbits for some time now :wink:

when you boot up the iso image there is a short boot selector dialog, there you can select an image test or also use e to actually edit the kernel parameters.

one source to chaise was: clr-installer/ at ac2cbde712a0c77d65a8e902503290afb24f431f · clearlinux/clr-installer · GitHub

I think it might have been a too full image file, it seem to have behaved different when I changed that in /usr/share/clr-installer/iso_template/initrd_init_template

and there I also actually found the isolinux.cfg.template which is controlling the
boot. It lacks some more chaising, like how the bios boot vs. efi works and where the boot.txt is coming from.

Anyhow, my menu I get is a ncurses style text selection dialog, where the official iso image looks to be some graphic mode.

This is why I say, it would be good to understand how the official image is actually build, with all of its needed parts, so one could reproduce the exact image with the same behaviour.

The official build is really just doing clr-installer -c live-server.yaml.

@btwarden as said above, its less about the yaml and more about the rest, like, how does the content of /usr/share/clr-installer look like when building.

A comment regards the yaml, where to find that one, the clr-installer github repo clr-installer/scripts at master · clearlinux/clr-installer · GitHub only has a:


Thats why I say, it would be handy to know the exact way.

/usr/share/clr-installer is created and populated by the build process for clr-installer itself. For the ISO templates, for example, see:

You can see the files populated during packaging here:

The installer configs and scripts for the current release are always published here:

So, in summary:

  1. Download and build clr-installer from source (or add the clr-installer bundle if you’re already running Clear Linux).
  2. Download the contents of /current/config/image.
  3. Run clr-installer -c live-server.yaml

That’s all you need to replicate our official builds.

I managed to build a live-desktop.img with text installer as I have a RTX4090 but failed to build the iso. Just followed the instructions at the clear linux github repo. I put the live-desktop.yaml in the /clr-installer/scripts folder before running ```
sudo .gopath/bin/clr-installer --config scripts/developer-image.yaml

Wouldn’t it be simpler to just download the clear-xxxxx-live-desktop.img (or, as the case may be, clear-xxxxx-live-server.img), and make it bootable?

BTW, how does one go about making that .img file bootable?

There are steps in the following issue request for taking the live-desktop.img and making it work. You will still need to boot into text mode for systems using NVIDIA graphics and run the text-based installer.

Be sure to run (sudo swupd clean) after booting into newly installed CL to free up space. There may be a regression in swupd or the CL installer not cleaning up after installation.

Edit: This is a backup plan when the live desktop ISO is missing.

I downloaded yesterday the latest bootable ISO for live desktop CL, and it works just fine, and made me happy. As such, all is well in Clear Linux land from this point of view.

1 Like

Ditto this. I just downloaded, used Balena Etcher to write to USB stick, and booted 37980 from the Clear Linux Download page. It’s now installied to disk.

I usually get the latest from here.