# Disclaimer
Despite my work this is still far from perfect!

The most notable problems are:
- limited driver support (Xbox 360 controller, etc.)
- GPU performance issues (mostly Nvidia)
- limited Windows compatibility

I'd recommend to test kde4el on a seperate machine for a bit of time before switching to it.

# Step One - Distribution
kde4el is not another Linux distrubution and instead builds off Enterprise Linux distributions. \
This gives the ability to choose an Enterprise Linux distribution from different vendors while having the same stable software and expreience. \
Here's a table of the following supported and tested Enterprise Linux distributions:

|Name|Origin|Website|Instructions|
|-|-|-|-|
|Oracle Linux|Oracle Corporation|[https://yum.oracle.com/](https://yum.oracle.com/)|[Text](https://docs.oracle.com/en/operating-systems/oracle-linux/9/install/) [Video](https://www.youtube.com/watch?v=5xhpV_WVt50)|
|Alma Linux|Alma Linux Foundation|[https://almalinux.org/](https://almalinux.org/)|[Text](https://wiki.almalinux.org/documentation/installation-guide.html)|
|Rocky Linux|Rocky Enterprise Software Foundation|[https://rockylinux.org/](https://rockylinux.org/)|[Text](https://docs.rockylinux.org/guides/installation/)|
|Miracle Linux|Cybertrust Japan Corporation|[https://www.miraclelinux.com/](https://www.miraclelinux.com/)|[Text](https://www.miraclelinux.com/distribution/install-guide)|

Once you haven chosen a distribution you will need to download the boot ISO and boot it. \
You can also follow the vendor's install instructions for additional help.

# Step Two - Repository Configuration
Everything in the Linux installer can be left as-is or be configured to your liking. \
Once you have configured everything you will need to configure the installation source to add the following repositories.

*The BaseOS repository needs to be added as the first repository and not as an additional repository*

## Oracle Linux
|Name|Protocol|URL Type|URL|
|-|-|-|-|
|ol9_baseos_latest|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/baseos/latest/x86_64/|
|ol9_appstream|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/appstream/x86_64/|
|ol9_codeready_builder|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/codeready/builder/x86_64/|
|ol9_developer|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/developer/x86_64/|
|ol9_developer_EPEL|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/developer/EPEL/x86_64/|
|ol9_UEKR7|https://|repository URL|yum.oracle.com/repo/OracleLinux/OL9/UEKR7/x86_64/|
|el9_kde4el|https://|repository URL|yum.groovyexpress.com/repo/kde4el/EL9/x86_64/|

## Alma Linux
|Name|Protocol|URL Type|URL|
|-|-|-|-|
|al9_baseos|https://|mirrorlist|mirrors.almalinux.org/mirrorlist/9/baseos|
|al9_appstream|https://|mirrorlist|mirrors.almalinux.org/mirrorlist/9/appstream|
|al9_extras|https://|mirrorlist|mirrors.almalinux.org/mirrorlist/9/extras|
|al9_crb|https://|mirrorlist|mirrors.almalinux.org/mirrorlist/9/crb|
|epel|https://|metalink|mirrors.fedoraproject.org/metalink?repo=epel-9&arch=x86_64|
|el9_kde4el|https://|repository URL|yum.groovyexpress.com/repo/kde4el/EL9/x86_64/|

## Rocky Linux
|Name|Protocol|URL Type|URL|
|-|-|-|-|
|rl9_baseos|https://|mirrorlist|mirrors.rockylinux.org/mirrorlist?arch=x86_64&repo=BaseOS-9|
|rl9_appstream|https://|mirrorlist|mirrors.rockylinux.org/mirrorlist?arch=x86_64&repo=AppStream-9|
|rl9_extras|https://|mirrorlist|mirrors.rockylinux.org/mirrorlist?arch=x86_64&repo=extras-9|
|rl9_crb|https://|mirrorlist|mirrors.rockylinux.org/mirrorlist?arch=x86_64&repo=CRB-9|
|epel|https://|metalink|mirrors.fedoraproject.org/metalink?repo=epel-9&arch=x86_64|
|el9_kde4el|https://|repository URL|yum.groovyexpress.com/repo/kde4el/EL9/x86_64/|

## Miracle Linux
|Name|Protocol|URL Type|URL|
|-|-|-|-|
|9-latest-BaseOS|https://|mirrorlist|repo.dist.miraclelinux.net/miraclelinux/mirrorlist/9/x86_64/baseos|
|9-latest-AppStream|https://|mirrorlist|repo.dist.miraclelinux.net/miraclelinux/mirrorlist/9/x86_64/appstream|
|9-latest-extras|https://|mirrorlist|repo.dist.miraclelinux.net/miraclelinux/mirrorlist/9/x86_64/extras|
|9-latest-PowerTools|https://|mirrorlist|repo.dist.miraclelinux.net/miraclelinux/mirrorlist/9/x86_64/powertools|
|epel|https://|metalink|mirrors.fedoraproject.org/metalink?repo=epel-9&arch=x86_64|
|el9_kde4el|https://|repository URL|yum.groovyexpress.com/repo/kde4el/EL9/x86_64/|

# Step Three - Software Selection
After setting up the installation source it should pull in the repository information. Once this has finished you can enter software selection.

In software selection you should choose Workstation (KDE) on the left panel and KDE Applications on the right panel. \
You can enable other groups on the right panel depending on what you want installed on your system.

You can now select Begin Installation to start the installation.

Once installation has finished you can then reboot and start using Linux. \
I'd recommend to choose the Plasma (X11) option when logging in which appears in the bottom left of the login screen. \
I'd also recommend to install programs from the Discover program. Just be sure to add Flathub as the default repository.

# Post Install
## Modify SELinux settings to allow Steam and Wine to work properly
1. Run the following commands in a terminal:
```
$ sudo su
# setsebool -P selinuxuser_execheap=1
# setsebool -P selinuxuser_execmod=1
```

## KDE Improvements
*Only for Oracle Linux*

1. Run the following commands in a terminal:
```
$ sudo su
# sed -i 's^LogoPath=.*^LogoPath=/usr/share/pixmaps/fedora-logo-sprite.png^g' /etc/xdg/kcm-about-distrorc
```
This will fix the logo in About this System for KDE System Settings.

```
# sed -i 's^"start-here"^"system-logo-icon"^g' /usr/share/plasma/look-and-feel/org.fedoraproject.fedora.desktop/contents/plasmoidsetupscripts/*.js
```
This will fix the Start icon. If you logged in before applying this fix you will have to manually adjust the icon for yourself.

## Enable the CodeReady repository and update the system
1. Run the following commands in a terminal:

For Oracle Linux:
```
$ sudo su
# yum config-manager --enable ol9_codeready_builder
# yum group install "kde4el KDE"
# yum group install "kde4el KDE Applications"
```

For everything else:
```
$ sudo su
# crb --enable
# yum group install "kde4el KDE"
# yum group install "kde4el KDE Applications"
```