💿 Getting the ISO
Download
⚠️ Every month there is a new ISO, it is recommended to use the latest.
- Download the ISO from the official ShuzzyOS Download Page.
Build
⚠️ This requires an Arch-based system.
1.📦 Install Required Packages
ShuzzyOS uses the official archiso package to build the custom ISO:
sudo pacman -S archiso
2.📁 Clone the Git Repository
The repository contains everything you need to build, modify, and configure the ISO — including all relevant dotfiles.
git clone https://github.com/RealShuzzy/ShuzzyOS.git
3.🔨 Build the ISO
Run the following commands to build the ISO:
cd ShuzzyOS
mkarchiso -v -w ./iso/output -o ./iso/output ./iso/baseline/
After the build completes, your ISO file will be located in:
./iso/output/
🔧 Creating a Bootable USB Drive
⚠️ Before installing ShuzzyOS, we need to make the ISO bootable.
Ventoy
✅ Ventoy is a great way to create a bootable USB Device, simply by copying the ISO to the USB-Stick.
1.💾 Download Ventoy
- Go to the official Ventoy Download Page and install what fits your current OS.
- Unzip the folder.
2.🔧 Format USB-Stick with Ventoy
- Now execute the
Ventoy2Diskand continue by selecting your USB-Stick and hittingInstall.
3.▶️ Copy ISO onto the USB-Stick
- Now we can finally use the ease of Ventoy by copying the ISO to the USB-Drivek.
Rufus (Windows)
⚠️ Rufus is a lightweight Windows-only tool to create a bootable USB Device.
1.💾 Download Rufus
- Go to the official Rufus Download Page and install what fits your current OS.
2.🔧 Select USB-Drivee and ISO
- Execute
rufus-(version) - Select your USB-Drive under
Device - Select the ISO under
Boot selection
3.▶️ Start
⚠️ **There is no need to change any settings.
- Select
STARTand wait until Rufus is done
Balena Etcher
✅ Balena Etcher is a cross-platform tool to create a bootable USB Device.
1.💾 Download Balena Etcher
- Go to the official Balena Etcher Download Page and install what fits your current OS.
2.🔧 Select USB-Drive and ISO
- Execute
balenaEtcher-(version).Setup - Select the ISO under
Flash from file - Select your USB-Drive under
Select Target
3.▶️ Flash
- Select
Flash!and wait until Balena Etcher is done

