Skip to content

Getting an ISO

First, we have two ways to obtain an ISO file.

If you want the convenience of saving time on building, you can choose to download the ISO from hosting services.
If you want your ISO to always be up-to-date, you can choose to build it from source code.

Obtain an ISO

RengeOS ISO (Minimal Edition)
Section titled “RengeOS ISO (Minimal Edition)”

Last time the ISO was built: 2026-02-11

SourceForge (Latest)

Obtain an ISO here: Download

Github Release (Latest)

Obtain an ISO here: Download

RengeOS ISO (Niri WM Edition) -> Coming Soon!
Section titled “RengeOS ISO (Niri WM Edition) -> Coming Soon!”

SourceForge (Latest)

Obtain an ISO here: Coming Soon!

Build it from source code (Arch-based)

Let’s get started!

With RengeOS ISO (Minimal Edition)

First, you need to git clone this folder to your HOME directory.

# You can replace ~ with $HOME if you want.
cd ~ && git clone https://github.com/RengeOS/Source-ISO && cd ~/Source-ISO/

Then run the build_iso script.

./build_iso

After the build process is complete, we will have the ISO file located in the out folder.
Inside the out folder, you will find the ISO file and the SHA256 checksum file.

With RengeOS ISO (Niri WM Edition) -> Coming Soon!

You might be wondering how to ensure the integrity of an ISO file when it’s downloaded.
Therefore, we will perform an additional step to verify the integrity of the ISO by comparing the ISO with the SHA256 hash following the steps below:

First, make sure you have downloaded the ISO file and the SHA256 ISO file to the same folder before testing!

[test@rengeos ~]$ ls test/
rengeos-2026.01.29-x86_64.iso  rengeos-2026.01.29-x86_64.iso.sha256

Now we will proceed to checksum the files.
Replace it with the SHA256 file of the ISO you downloaded earlier, and here is an example:

[test@rengeos ~]$ cd test/ && sha256sum -c rengeos-2026.01.29-x86_64.iso.sha256
rengeos-2026.01.29-x86_64.iso: OK

If it says OK as above, then your ISO is definitely fine; otherwise, I recommend you download a new ISO.