Want to help support our work? Helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.
The full read me file for winesapOS can be found here.
Setup instructions and system requirements can be found here.
Download links:
Built using archlinux-2024.02.01-x86_64.iso.
Feature highlights:
- Use upstream Arch Linux packages.
- Release builds will use vanilla Arch Linux now instead of a hybrid of new Arch Linux packages and SteamOS packages.
- This change makes winesapOS a much more stable and reliable operating system.
- The major version of winesapOS has been increased from 3 to 4 to signify this change.
- Release builds will use vanilla Arch Linux now instead of a hybrid of new Arch Linux packages and SteamOS packages.
- Linux T2 is now the default boot kernel.
- This will provide better out-of-the-box hardware support.
- Linux LTS is still installed and available to use.
- Linux LTS has been upgraded from 6.1 to 6.6.
- Chaotic AUR repository added.
- Many Arch Linux User Repository packages are now provided by the Chaotic AUR repository.
- Support for more file systems:
- CephFS
- GFS2
- GlusterFS
- Conversion script.
- A simple conversion script is provided to install packages similar to what winesapOS has but on your operating system of choice.
- Better hardware and boot support.
- initramfs is now built with all Linux kernel modules.
- Microcode updates for AMD and Intel processors are now pre-installed.
- Improved support for USB hubs and NVMe drives.
- Support for Intel Optane drives as the primary boot drive.
- A troubleshooting guide is provided to help with common boot issues.
Project highlights:
- Almost 800 GitHub stars!
- Over 100 commits since our last release.
- Exactly 50 GitHub Issues addressed.
- Over 95% of all GitHub Issues ever made for winesapOS have been addressed still.
Upgrades:
- Before upgrading, please read the upgrade notes.
- Follow this guide in our README.md file on how to perform a system upgrade.
- Major upgrades from Mac Linux Gaming Stick 2 or winesapOS 3 to winesapOS 4 can be done following this guide.
Issues addressed since 3.4.0:
- Steam Deck controller may not work.
- Steam Deck LCD and OLED do not boot.
- This was due to bug in the Steam Deck BIOS. Update to the SteamOS 3.5.11 preview or newer. The SteamOS 3.5.17 release was the first stable release to fix this.
Known issues:
- Steam Deck OLED does not have working sound or Wi-Fi.
- ASUS ROG Ally does not boot with Linux T2 which has full hardware support including sound.
- Boot with "Arch Linux, with Linux linux-lts".
- Go through the entire winesapOS first-time setup.
- Reboot and then select "Arch Linux, with Linux linux-t2".
- As of 2024-03-07, Arch Linux has upgraded KDE Plasma 5 to 6.0.0 but upgrades are broken. This means that a winesapOS upgrade, by extension, leads to a broken desktop environment.
- As a short-term workaround, install an alternative desktop environment such as Cinnamon.
- Open a TTY console by pressing
CTRL+ALT+4. sudo pacman -S cinnamon maui-pix xed- Restart LightDM:
sudo systemctl restart lightdm - Find the previous TTY with
wand then go back withCTRL+ALT+<TTY_NUMBER>. - At the login page of LightDM, select the wrench icon in the top-right to change the desktop environment to Cinnamon before logging in.
- Open a TTY console by pressing
- As a long-term solution, wait for the winesapOS 4.1.0 release before upgrading.
- As of winesapOS 4.1.0-alpha.0 and KDE Plasma 6.0.3, upgrades are now working.
- Run the following commands to upgrade to it:
export WINESAPOS_UPGRADE_VERSION_CHECK=false curl https://raw.githubusercontent.com/LukeShortCloud/winesapOS/4.1.0-alpha.0/scripts/winesapos-upgrade.sh | sudo -E bash
- As a short-term workaround, install an alternative desktop environment such as Cinnamon.
The full change log can be found here.
What's next?
We are exploring different ways to provide an installer. This will make it much easier for users to install winesapOS to an internal drive. This will also open the door to support dual-boot with other operating systems on the same storage device.