Skip to content

💿 XeroLinux Distro 💿

Info

In a nutshell, the XeroLinux ISO bundles all my scripts, toolkit, and custom rice into a seamless, easy-to-install package, skipping the hassle of running the ArchInstall script entirely. No more, no less. Source Code

Thank you

Before we begin, I would like to tell everyone of you who has supported the XeroLinux project by either getting the ISO or some merch, how much your simple act of kindness means to me. I cannot put it into words. So all am gonna say is God bless you all. I hope your kindness is reciprocated. 🙏❤️

In case you haven't gotten your copy yet, check out how to » Here.

rice


.// The Wiki \\.

Installation

Warning

When it comes to Encryption, Calamares is meh when it comes to that. It's extremely limited. It can't ecrypt both boot n root, just the latter (I think). I do not use it myself so my knowledge there is extremely limited. Use at your own RISK.

Before we dive in, it's important to note that XeroLinux features KDE Plasma, a powerful and feature-rich desktop environment. While it’s designed to run on a variety of systems, for the best experience, we recommend mid-range or higher hardware. That said, it can work on low-end hardware, but performance may be less than optimal. Check the requirements below for more details!

Minimum Recommended
4GB RAM (DDR3+) 8GB+ RAM (DDR3+)
16GB HDD/SSD Storage 32GB+ HDD/SSD Storage
Modern iGPU (512MB vRAM) Modern dGPU (4GB+ vRAM)

Bootable Tool

To boot into the Distro's Live Environment, all you have to do is use the tried and true Ventoy to put ISO on & boot, that way you have Grub as fallback in case SystemD-Boot fails. If you burn using Etcher or similar tools there will be nothing to fall back to. Just an FYI.

rice

Calamares Installer

Calamares will auto-launch on boot. Just go through the motions and when you get to the user creation page, if you select the Autologin option, you will be logged in to an X11/Xorg session, not Wayland, we chose that for compatibility with legacy hardware nothing more.

You can still switch to Wayland post-install either via KDE's SDDM settings or the included toolkit, choice is yours. I recommend toolkit as system settings tend to be buggy.

rice

Anyway, the installer is and will always function in offline mode, meaning that while no actual Internet connection is required during install, it's highly recommended you do have one in order to be able to update later on.

XeroLinux Toolkit

I highly recommend using the toolkit (the first icon on the dock) to streamline your initial setup experience. It was designed to make the process much smoother and more pleasant. Keep in mind, however, that it's not meant to handle everything for you, just the essentials.

For more info about it check the Wiki

rice

Supported Filesystems

Also, the currently supported Filesystems are, ext4, btrfs and xfs. I don't know much about btrfs so I will try my best to help there, just do not expect me to have all the answers regarding it, sorry.

GUI Package Managers

Additionally, I'd like to point out that no GUI package managers are included by default, as I believe in giving you the freedom to choose the one that suits your workflow best. Through the provided toolkit, you can select from Octopi, PacSeekTUI, or Bauh. That said, I strongly advise against installing KDE's Discover if you're aiming for stability; it's notoriously troublesome. But, as always, the final decision is yours.

Support/Issues

If you encounter any other issues or have questions directly related to the installation, feel free to reach out to me on Fosstodon or Discord. All relevant links are provided in the footer, and I'll do my best to assist you.

rice

However, if your questions are related to your specific hardware, I may not have the answers you're looking for, as my knowledge is limited to what works on my own systems. For hardware-specific queries, your best resources are the ArchWiki, or our custom ChatGPT A.I. available on Discord.

As for any KDE related issues, you are kindly requested to report them over on the KDE Bugtracker.

That's it, there ain't much to it. The rest is in your hands now. Dive into the toolkit, poke around, and see if there’s anything that catches your fancy. Just don’t blame me if you get lost in the endless sea of tweaks and options 🎉