Skip to content

Commit

Permalink
requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
DarkXero-dev committed Sep 23, 2024
1 parent 133e199 commit 8d85eec
Show file tree
Hide file tree
Showing 5 changed files with 72 additions and 19 deletions.
40 changes: 35 additions & 5 deletions docs/distro.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,25 +28,55 @@ In case you haven't gotten your copy yet, check out how to » [**Here**](https:/

When it comes to **Encryption**, I haven't tested it thoroughly. Use at your own Risk! **Calamares** is meh when it comes to that. All I know is it's extremely limited. It can't ecrypt both `boot` n `root`, just one or the other. Am sorry I test what I can. Please report any findings to me on [**Discord**](https://discord.gg/HPkEc38AcB){:target="_blank"}.

To install the distro, all you have to do is use the tried and true [**Ventoy**](https://xerolinux.xyz/posts/ventoy-multi-boot/){:target="_blank"} 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.
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**

- 4GB RAM (DDR3+)
- 16GB HDD/SSD Storage
- Modern iGPU (512MB vRAM)

**Recommended**

- 8GB+ RAM (DDR3+)
- 32GB+ HDD/SSD Storage
- 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**](https://xerolinux.xyz/posts/ventoy-multi-boot/){:target="_blank"} 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**

<p align="center">
<img src="https://i.imgur.com/QsLRWtG.png" alt="rice">
</p>

[**Calamares**](https://github.com/calamares/calamares){:target="_blank"} 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. Yes you can still switch to *Wayland* post-install, just use the toolkit, it's under option **7. System Troubleshooting & Tweaks >> 6. Change Autologin Session X11/Wayland (SDDM)** and select *Wayland*, reboot, done.
[**Calamares**](https://github.com/calamares/calamares){:target="_blank"} 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.

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**

You can still switch to *Wayland* post-install, just use the toolkit, it's under option **System Troubleshooting & Tweaks >> Change Autologin Session X11/Wayland (SDDM)** and select *Wayland*, reboot, done.

<p align="center">
<img src="https://i.imgur.com/yym6CPo.png" alt="rice">
</p>

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. 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.
**Included Filesystems**

We have also had no choice but to disable the **Swap+/-Hibernate** options due to an ongoing issue with latest version of **Calamares**. Will be re-added at some point in the future. Until then you can still use **Swap File** only if you have *8GB* or less RAM otherwise it would be a waste of space.
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.

## Complications

If you encounter any 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.
We have had no choice but to disable the **Swap+/-Hibernate** options due to an ongoing issue with latest version of **Calamares**. Will be re-added at some point in the future. Until then you can still use **Swap File** only if you have *8GB* or less RAM otherwise it would be a waste of space.

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.

<p align="center">
<img src="https://i.imgur.com/6qyA6nM.jpeg" alt="rice">
</p>

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**](https://wiki.archlinux.org){:target="_blank"}, or our custom **ChatGPT A.I.** available on **Discord**.

Expand Down
33 changes: 28 additions & 5 deletions site/distro/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -527,20 +527,43 @@ <h2 id="installation">Installation<a class="headerlink" href="#installation" tit
<p class="admonition-title">Warning</p>
<p>When it comes to <strong>Encryption</strong>, I haven't tested it thoroughly. Use at your own Risk! <strong>Calamares</strong> is meh when it comes to that. All I know is it's extremely limited. It can't ecrypt both <code>boot</code> n <code>root</code>, just one or the other. Am sorry I test what I can. Please report any findings to me on <a href="https://discord.gg/HPkEc38AcB" target="_blank"><strong>Discord</strong></a>.</p>
</div>
<p>To install the distro, all you have to do is use the tried and true <a href="https://xerolinux.xyz/posts/ventoy-multi-boot/" target="_blank"><strong>Ventoy</strong></a> to put ISO on &amp; boot, that way you have <strong>Grub</strong> as fallback in case <strong>SystemD-Boot</strong> fails. If you burn using <strong>Etcher</strong> or similar tools there will be nothing to fall back to. Just an FYI.</p>
<p>Before we dive in, it's important to note that <strong>XeroLinux</strong> features <strong>KDE Plasma</strong>, 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!</p>
<p><strong>Minimum</strong></p>
<ul>
<li>4GB RAM (DDR3+)</li>
<li>16GB HDD/SSD Storage</li>
<li>Modern iGPU (512MB vRAM)</li>
</ul>
<p><strong>Recommended</strong></p>
<ul>
<li>8GB+ RAM (DDR3+)</li>
<li>32GB+ HDD/SSD Storage</li>
<li>Modern dGPU (4GB+ vRAM)</li>
</ul>
<p><strong>Bootable Tool</strong></p>
<p>To boot into the Distro's Live Environment, all you have to do is use the tried and true <a href="https://xerolinux.xyz/posts/ventoy-multi-boot/" target="_blank"><strong>Ventoy</strong></a> to put ISO on &amp; boot, that way you have <strong>Grub</strong> as fallback in case <strong>SystemD-Boot</strong> fails. If you burn using <strong>Etcher</strong> or similar tools there will be nothing to fall back to. Just an FYI.</p>
<p><strong>Calamares Installer</strong></p>
<p align="center">
<a class="glightbox" href="https://i.imgur.com/QsLRWtG.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img src="https://i.imgur.com/QsLRWtG.png" alt="rice"></a>
</p>

<p><a href="https://github.com/calamares/calamares" target="_blank"><strong>Calamares</strong></a> will auto-launch on boot. Just go through the motions and when you get to the user creation page, if you select the <em>Autologin</em> option, you will be logged in to an <strong>X11/Xorg</strong> session, not <strong>Wayland</strong>, we chose that for compatibility with legacy hardware nothing more. Yes you can still switch to <em>Wayland</em> post-install, just use the toolkit, it's under option <strong>7. System Troubleshooting &amp; Tweaks &gt;&gt; 6. Change Autologin Session X11/Wayland (SDDM)</strong> and select <em>Wayland</em>, reboot, done.</p>
<p><a href="https://github.com/calamares/calamares" target="_blank"><strong>Calamares</strong></a> will auto-launch on boot. Just go through the motions and when you get to the user creation page, if you select the <em>Autologin</em> option, you will be logged in to an <strong>X11/Xorg</strong> session, not <strong>Wayland</strong>, we chose that for compatibility with legacy hardware nothing more.</p>
<p>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.</p>
<p><strong>XeroLinux Toolkit</strong></p>
<p>You can still switch to <em>Wayland</em> post-install, just use the toolkit, it's under option <strong>System Troubleshooting &amp; Tweaks &gt;&gt; Change Autologin Session X11/Wayland (SDDM)</strong> and select <em>Wayland</em>, reboot, done.</p>
<p align="center">
<a class="glightbox" href="https://i.imgur.com/yym6CPo.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img src="https://i.imgur.com/yym6CPo.png" alt="rice"></a>
</p>

<p>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. Also, the currently supported <strong>Filesystems</strong> are, <code>ext4</code>, <code>btrfs</code> and <code>xfs</code>. I don't know much about <code>btrfs</code> so I will try my best to help there, just do not expect me to have all the answers regarding it, sorry.</p>
<p>We have also had no choice but to disable the <strong>Swap±Hibernate</strong> options due to an ongoing issue with latest version of <strong>Calamares</strong>. Will be re-added at some point in the future. Until then you can still use <strong>Swap File</strong> only if you have <em>8GB</em> or less RAM otherwise it would be a waste of space.</p>
<p><strong>Included Filesystems</strong></p>
<p>Also, the currently supported <strong>Filesystems</strong> are, <code>ext4</code>, <code>btrfs</code> and <code>xfs</code>. I don't know much about <code>btrfs</code> so I will try my best to help there, just do not expect me to have all the answers regarding it, sorry.</p>
<h2 id="complications">Complications<a class="headerlink" href="#complications" title="Permanent link"></a></h2>
<p>If you encounter any issues or have questions directly related to the installation, feel free to reach out to me on <strong>Fosstodon</strong> or <strong>Discord</strong>. All relevant links are provided in the footer, and I'll do my best to assist you.</p>
<p>We have had no choice but to disable the <strong>Swap±Hibernate</strong> options due to an ongoing issue with latest version of <strong>Calamares</strong>. Will be re-added at some point in the future. Until then you can still use <strong>Swap File</strong> only if you have <em>8GB</em> or less RAM otherwise it would be a waste of space.</p>
<p>If you encounter any <em>other</em> issues or have questions directly related to the installation, feel free to reach out to me on <strong>Fosstodon</strong> or <strong>Discord</strong>. All relevant links are provided in the footer, and I'll do my best to assist you.</p>
<p align="center">
<a class="glightbox" href="https://i.imgur.com/6qyA6nM.jpeg" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img src="https://i.imgur.com/6qyA6nM.jpeg" alt="rice"></a>
</p>

<p>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 <a href="https://wiki.archlinux.org" target="_blank"><strong>ArchWiki</strong></a>, or our custom <strong>ChatGPT A.I.</strong> available on <strong>Discord</strong>.</p>
<p>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 🎉</p></div>

Expand Down
2 changes: 1 addition & 1 deletion site/search/search_index.json

Large diffs are not rendered by default.

16 changes: 8 additions & 8 deletions site/sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,42 +2,42 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://wiki.xerolinux.xyz/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/SUMMARY/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/cosmic/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/distro/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/grub/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/plasma/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/rice/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://wiki.xerolinux.xyz/xlapit/</loc>
<lastmod>2024-09-20</lastmod>
<lastmod>2024-09-23</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>
Binary file modified site/sitemap.xml.gz
Binary file not shown.

0 comments on commit 8d85eec

Please sign in to comment.