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.

Last time the ISO was built: 2026-03-20

SourceForge (Latest)

Obtain an ISO here: Download

Minimal-Edition


Last time the ISO was built: 2026-03-20

SourceForge (Latest)

Obtain an ISO here: Download

NiriWM-Edtion


Download from Github and combine each ISO part

Section titled “Download from Github and combine each ISO part”
  • First, you need to know which files we need to download to combine them into a complete ISO.
  • We need to download the parts with the extension .iso.part001, .iso.part002, etc.

1

  • After downloading, I’ve saved them in the ~/Downloads/ folder, and we’ll combine them into a complete ISO.
Terminal window
# I need to move to the location where the downloaded parts are stored.
cd ~/Downloads/
# Now let's combine them.
cat rengeos-niriwm-2026.03.20-x86_64.iso.part* > rengeos-niriwm-2026.03.20-x86_64.iso

Let’s get started!

  • First, you need to git clone this folder to your HOME directory.
Terminal window
# You can replace ~ with $HOME if you want.
cd ~ && git clone --branch minimal-iso https://github.com/RengeOS/Source-ISO && cd ~/Source-ISO/
  • Then run the build_iso script.
Terminal window
./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.

  • First, you need to git clone this folder to your HOME directory.
Terminal window
# You can replace ~ with $HOME if you want.
cd ~ && git clone --branch niriwm-iso https://github.com/RengeOS/Source-ISO && cd ~/Source-ISO/
  • Then run the build_iso script.
Terminal window
./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.

  • 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!
Terminal window
[test@rengeos ~]$ ls test/
rengeos-2026.03.20-x86_64.iso rengeos-2026.03.20-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:
Terminal window
[test@rengeos ~]$ cd test/ && sha256sum -c rengeos-2026.03.20-x86_64.iso.sha256
rengeos-2026.03.20-x86_64.iso: OK
  • If it says OK as above, then your ISO is definitely fine; otherwise, I recommend you download a new ISO.
  • After the ISO download process is complete, you’ll probably want to create a bootable USB drive.