💿 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.
.// 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.
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.
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
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.
ISO Differences¶
The KDE Plasma version is and always will be the main edition. I call it the Flagship simply because it's the DE I love and contribute to the most. It can be unstable at times however, since it's constantly evolving and keeps getting new features non stop making the most customizable/riceable DE out there. That's why I love it so much. So it's targeted to anyone who likes that sort of stuff and don't mind a few bugs here n there...
As of February of 2025, a new Gnome Dev-Spin has been/will be added to the mix. The key differences between it and the KDE Flagship is that it's more oriented to those of you who do not game much, and prefer to have a stable system that stays out of your way while you do your work. It also hasn't been riced, eg no custom theme has been used, following the Gnome Guidelines. All I did was use the Accent color feature to enable the Purple colors, and for consistency, I applied the Tela Circle Purple icon theme, while including just enough extensions making it more functional.
Gnome Note :
I highly recommend against installing too many extensions if you want to keep your system stable. Also, please avoid using any themes, as they might cause overall issues since the Gnome devs do not like it when you do. In the end it's all up to you. You have been warned ;)
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.
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 🎉