main branch: development (latest, unstable)
- joekamprad
- manuel
- fernandomaroto (initial developer)
- keybreak
- ..and our beloved community
This ISO is based on a heavily modified Arch-ISO, designed to provide the installation environment for EndeavourOS.
For more information, please visit the EndeavourOS-GitHub-Development page.
Our journey is made possible the generosity of our Open Collective community!
- EndeavourOS-ISO source (Live environment with KDE-Desktop)
- Calamares {EndeavourOS fork} (installer framework)
Systemd-boot for UEFI systems:
Bios-boot (syslinux) for legacy systems:
You must use an existing EndeavourOS system, or any Arch-based system with the EndeavourOS repository enabled, to build an EndeavourOS ISO. This is because the installer's packages and dependencies will be fetched from the EndeavourOS repository.
More general info: EndeavourOS Development Information
You can also read the CHANGELOG to learn more about the latest changes before you start.
Run the following command on your existing system:
sudo pacman -S archiso git squashfs-tools --needed
It's recommended to reboot your system after letting this command complete.
To build the ISO using the latest release state, download its tagged tarball from this repo. For example, to use the stable release 23.11.1.2 (Galileo KDE):
- Download its tarball
wget https://github.com/endeavouros-team/EndeavourOS-ISO/archive/refs/tags/23.11.1.2.tar.gz - Extract the tarball
tar -xvf 23.11.1.2.tar.gzNavigate into the foldercd "EndeavourOS-ISO-23.11.1.2" - Run the preparation script
./prepare.sh
If you want the last release state to rebuild the ISO, you need to use a specifically tagged tarball from here: https://github.com/endeavouros-team/EndeavourOS-ISO/tags
If not, it will default to using the latest "unstable" development state.
example using latest stable release (23.11.1.2 Galileo KDE Release)
Warning: do not use the .zip tarballs, as they may cause issues with symlinks.
git clone https://github.com/endeavouros-team/EndeavourOS-ISO.git
cd EndeavourOS-ISO
./prepare.sh
If that you can use older tags like:
wget https://github.com/endeavouros-team/EndeavourOS-ISO/archive/refs/tags/22.12.2.tar.gz
tar -xvf 22.12.2.tar.gz
cd "EndeavourOS-ISO-22.12.2"
./prepare.sh
But caused by the change to KDE these iso will use XFCE4 LiveSession and you will need to build calamares manually to get old style theming that is setup for the XFCE4 LiveSession:
using this PKGBUILD: https://raw.githubusercontent.com/endeavouros-team/PKGBUILDS/18e3f580abb68486091492168956619bb0f32abe/calamares/PKGBUILD
And put the resulting package into ISO structure to get installed with the ISO build procedure:
airootfs/root/packages/
To get this working you need to remove calamares from packages.x86_64 before starting ISO build.
sudo ./mkarchiso -v "."
or with log:
sudo ./mkarchiso -v "." 2>&1 | tee "eosiso_$(date -u +'%Y.%m.%d-%H:%M').log"
To install locally built packages on ISO, put the packages inside the following directory:
airootfs/root/packages
Packages will be installed and the directory will be cleaned up after that.
Example:
EndeavourOS_Galileo-Neo-2024.01.25.iso
EndeavourOS_RELEASENAMEREBUILD-YYYY.MM.DD.iso
- YYYY.MM.DD: of the release
- REBUILD: (empty), -Neo, -Nova