Skip to content

Our installation medium is already very stable and covers some hardware-specific peculiarities, but it is not an egg-laying wool milk sow. With this, it is possible to install the OS in many different ways, related to partition, format, encryption.

But there are limitations of what is possible to provide over the used framework.

Always keep in mind that EndeavourOS install and enable some stuff by default:

Other things are disabled by default for your security and to keep things simple:

Here we collect some information to resolve common issues with the installation process:

Preliminary remarks on installation in general (EFI, Bios, legacy, CSM, fastboot, secure-boot)

64-bit only: The ISO itself can be used as it is to boot on most Computers supporting x86-64 (x64, x86_64, AMD64, Intel 64) known as 64-bit. From old systems running on legacy Bios [Basic Input systems] to modern UEFI (EFI) [Unified Extensible Firmware Interface].

EFI/BIOS: In case, modern EFI systems can provide the option to support legacy boot so called CSM mode (Compatibility Support Module) Best is to disable this feature if possible, as the installer is not always detecting this correctly. In case you are dual booting with Windows installed in legacy mode, the options are indeed limited to go reinstall Windows in EFI mode or try to add EndeavourOS in CSM legacy mode.

Secureboot: The main downside is that we do still not support secure-boot, so this feature must be disabled to be able to install EndeavourOS in most cases. There are some Firmware opting to add secure-boot keys manually, but these are rare.

Fastboot: The fastboot feature from Windows (in case you want to dual boot) needs to be disabled as it will cause issues with hardware like Bluetooth or Wireless devices would not show up.

Create the install media (USB key)
Slow Internet unstable Connections

In some places, you do have not that stable internet connection, or you are connected over Wi-Fi with a bad bandwidth. Another reason can be restrictions from ISP so that you can not reach servers.

We have some implementations built in to detect and rank mirrors, but the procedure is known to not work in some parts of the world where you have only some not stable mirrors (India, Pakistan, Brazil p.e.).

In this case, the best to do is to use the “update mirrors” tool from the welcome application:

Make sure the resulting mirrorlist has at least 8 mirrors showing up, and save it.

Now start the installer, and you will be able to install via the online option.


The easiest way is to use the automatic options to partition your drive/s, you will find 3 main options to apply that:

Alongside: this will shrink the main system partition of the drive selected and add all needed partitions automatically, in case you can choose to create a new ESP in any case too also an existing one already would fit the minimum requirements:

Replace: useful in case of reinstall to overwrite one partition only and leave the rest intact.

Erase: this will simply use the complete drive and create everything new, deleting everything ion the selected drive!

Manual partitioning:

This is advanced usage! Handle with care.

The requirements for modern EFI (UEFI) systems:

Partition Table must be GPT here.

  1. ESP (Efi System Partition) :

If you take systemd-bootloader:

Fat32, flagged as boot, Mount Point: /efi, Minimum size: 1024MB (1GB)

If you choose Grub Bootloader:

Fat32, flagged as boot, Mount Point: /boot/efi, Minimum size 300MB.

2. System Partition

Possible format ext4 or BTRFS Mount Point /

Older Bios Systems:

If you can only boot into CSM (Compatibility Support Module) or on real older non-efi Bios systems.

This could be the case if Windows is installed in that mode already, and you do not want to reinstall Windows in EFI mode.

You have 2 Options here:

First Option: is the old standard using the MBR (Master Boot Record, first sector of a hard disk):

Bootloader will get written into the MBR of a msdos partition table, here you need only one System Partition,

mounted as /, flagged as boot.

The Second Option: is to use a GPT partition table, and create an 8MB sized **empty** partition, flagged as bios-grub.

In this case, Bootloader will get installed onto the “grub-drive”.


If you choose BTRFS it will create a preset of subvolumes with automate partition options, and on manual partitions it will resolve subvolumes too.

See here:

Recommendation is to only take BTRFS if you know why you would need to, it is not only another faster more fancy filesystem, and needs some knowledge to earn beforehand!

Installer can not create partition

In some cases, it is a good thing to delete the partitions you want to use for EndeavourOS before starting the installation. You can simply use KDE partition Manager, which you can start with the button in the welcome app or via the menu of the live environment.

In 2024, we added GParted in addition, to the ISO for your convenience.

Advanced installer options

You can unselect packages you do not need:

This option is only available for online install method!

EndeavourOS Desktop Fixes and Theming

EndeavourOS has preset small changes to the settings and themes for all desktop installations to fix problems with the default settings and smooth the interfaces. In addition, XFCE4 and i3-WM are heavily modified.

If you want an unchanged installation, you can easily turn off these changes by deselecting the appropriate subgroup:

What to do if install fails or i have issues?

In case the installation is not successful, do not reboot or exit the live session! Please send us the installer log on the forum, over telegram chat or even email, we can always make great use of them to fix issues and bugs with the installer:

You ca use the log tool from the panel and send log to Pastebin (internet connection required).

Run the log tool with inxi and install log tagged:

And post the URL it creates in this little popup window on forum, chat or send it via email:

Connect with us, we will be happy to help in any way:

For encrypted installation help/info go here

More info about encrypted installation.

Installer process slideshow:

Live ISO installer info tricks & tips

  • by