ReignOS

ReignOS is a SteamOS / SteamDeck like rolling Arch distro but with its own unique take focused on general portability. It supports Gamescope, Weston, Cage, X11 and KDE compositors for better compatibility with some hardware. In short ReignOS is similar to ChimeraOS or BazziteOS but is non-immutable and allows for newer or different kernels, drivers, options etc.

AMD, Intel and Nvidia GPUs supported
Hybrid-Graphics, mGPU and eGPU systems supported
Most General PC hardware should just work
Dual-Boot with Windows or other Linux distros

Known working hardware

Desktops, MiniPCs, Laptops etc
MSI-Claw AM1
MSI-Claw 7/8 AI+ A2VM
Asus ROG Ally (Z1, Z1 Extreme and X)
Legion Go (1, 2 and S)
Ayaneo devices (Slide, FlipDS, Kun, Ayaneo3 Magic Modules etc)
OneXPlayer devices (both AMD and Intel)
Antec devices (CoreHS)
Ayn devices (Loki Zero)
Aokzoe devices
Anbernic devices (Win600)
Zotac Zone
TJD 10.1" Handheld

How to Install

Download latest ISO image
Use Balena Etcher to create bootable USB
NOTE: If 'Balena Etcher' fails, use Fedora Media Writer to reset the USB drive, then try again
Disable SecureBoot in your BIOS (Common keys are Esc, F2, Del)
If you're Dual-Booting with Windows, disable Windows Bitlocker or resize partitions with Windows DiskManager instead of Gparted
NOTE: If you want to boot from MicroSD card and its not supported in BIOS, you still can if you put ReignOS_EFI partition on main drive
Boot USB using a Dock or USB-Hub if installing on Handheld device
Follow on screen instructions
NOTE: After reboot there will be an extra 'FirstRun' install step (let it fully finish as it can take some time)
NOTE: If FirstRun fails, type "exit" and hit enter and it will try again
After installation is finished, its recomended to Sign-In to Steam via KDE first not Gamescope as it gives you more visual feedback
After installation, use KDE to configure extra storage in Steam
NOTE: If Steam is failing to open, you can click the "Reinstall Steam" button in Control-Center

Post-Install Notes

Enable "MangoHud" in Control-Center to get FPS/TDP monitor overlays working.
You can use Control-Center to default to booting a particular compositor like Gamescope
You can always return to Control-Center by exiting Steam (Switch to Desktop in Gamescope) or Logging out of KDE
Look at "GPU Troubleshooting" if Control-Center is not launching (changing its compositor can resolve issue)
If you want Steams performance overlay functionality, enable MangeHud in Control-Center
If you use HHD TDP control, you may need to use the Bazzite kernel as well
Some Intel or Nvidia hardware can be more stable with Weston/Cage vs Gamescope (Like MSI-Claw devices)
Some older/slower hardware is more stable/faster with X11 (like Intel Atom)
ReignOS allows volume up to 150% but Steams volume interface caps at 100% visually

Installer Troubleshooting

Tethered networks may have issues (WiFi or Ethernet over Dock prefered)
If the install fails, hit the 'Exit' button which will cause it to restart installer without reboot
You can try with "Refresh Integrity" on/off (on normally better)
If the installer is not opening, hit Ctrl+C then type: './install.sh <-cage, -labwc, -weston or -x11>'

Device specific fixes

Ayaneo Slide / Antec Core HS
- Enable sleep support

* See "General Ayaneo Devices" below.
* NOTE: Slide/CoreHS only partially works correctly with S0i2 not S0i3

- Fix random reboots

* In Control-Center make sure acpi=strict is checked
* Then make sure you reboot device once after install so this setting takes effect
- Stability recommendations

* TDP managers like HHD or DeckyTDP can cause stability issues on this hardware
* Its highly recomended to use "PowerProfiles" on this hardware which doesn't have the issue
Ayaneo Flip DS
- Enable sleep support

* In Ayaneo downloads you must use the BIOS labeled Support MS sleep

- Fix Audio

* In Control-Center, use Bazzite Kernel and click Apply

- Fix Default Display

* In Control-Center, use Display page to "Enable" a top display only
* In KDE, set both displays to 100% scaling

- Fix Touchscreens

* In Control-Center, use Bazzite Kernel and click Apply
* In Control-Center, use InputPlumber and click Apply
* In KDE, open Settings->Touchscreen and set these in Device list
    - Set Device 1 "Target display" to "(0,0 1920*1080)"
    - Set Device 2 "Target display" to "(468,1080 960*640)"
    - Set Device 3 "Target display" to "Automatic"

- ReignOS Monitor app

* In Control-Center, enable ReignOS.Monitor
* Open KDE Desktop, open settings and search for "Window Rules"
* Add a rule and enter "ReignOS.Monitor" in "Window class" section
* Click "Add Property" and add "Screen" and make index 1
* Click "Add Property" and add "Fullscreen" and make it "Apply initially" to "Yes"
Ayaneo Kun
- Fix Audio

* In Control-Center, use Bazzite Kernel and click Apply
Ayaneo 3
- Magic Modules

* Control Center allows you to eject these with any kernel but Bazzite kernel recomended
General Ayaneo Devices
- Sleep not working

* Boot into BIOS
* Naviage to "AMD PBS->Power Saving Configurations"
* Change "S3 Enable" to "Modern Standby Enable"
* Make sure "Modern Standby Type" is set to "Modern Standby + S0i2 + S0i3" (or just "Modern Standby + S0i2" if S0i3 has issues)
* Save and exit
* NOTE: If your BIOS doesn't expose "AMD PBS" you can put Smokeless UMAF on a FAT32 drive and boot it to access.

- Controller not working

* Some Ayaneo devices will sleep the controller. Simply hold 'B' button and it will come back on

- Spamming audio alert in KDE

* Use Control-Center to switch to InputPlumber or HHD
Rog Ally
- Fix "Adjust Display Colors" settings

* Some hardware need a patched kernel for color tempature
* So in Control-Center, use Chimera, Bazzite or Cachy kernels
General hardware
- Fix Display Colors in Gamescope

* In Control-Center, click "Display" button
* In Display page under "Gamescope conf" click "Generate"
* In Gamescope->Display settings, click "Generate"

- TDP

* HHD TDP may require Bazzite kernel to work

- Extra WiFI Drivers

* yay -S rtl8812au-dkms-git
* yay -S rtl8814au-dkms-git
* yay -S rtl88x2bu-dkms-git
* yay -S rtl8821au-dkms-git

(User / Pass) Notes

Linux User: 'gamer' (changing this can break operation)
Linux Pass: 'gamer' (changing this can break operation)
Linux root User: 'root' (changing this can break operation)
Linux root Pass: 'gamer' (changing this can break operation)

Auto mount internal drives

In KDE, open "KDE Partition Manager"
Unmount the partition you want to change setting on if mounted
Right-Click on partition and click "Edit Mount Point"
Change "Path" to something like "/mnt/games
Click, ok then reboot to confirm working
Once mounted you may need to change permission to write drive
* Right-Click in mounted drive and "Open Terminal Here"
* sudo chown -R gamer:gamer ./
* sudo chmod -R u+rwX ./

BIOS Notes

Some Acer Laptops need 'Touchpad' in BIOS to be set to 'Basic' not 'Advanced' to work
Some Acer Laptops need you to set BIOS password before you can disable Secure-Boot

Control Center

Select what compositor to boot with or set boot default
Set screen rotation
Manage Nvidia or AMD drivers
Boot Manager: This allows you to boot to Windows or any other OS
Network Manager: Allows you to manage WiFi connection
Disk Manager: Allows you to format extra game drives, like MicroSD cards etc
Display Manager: Allows you to configure default display etc
Audio Manager: Lets you set default audio device
Power Manager: Lets you configure power settings when using PowerProfiles
NOTE: Use KDE to sign into Steam if you have issues with others. Then try another.

Compositors

Gamescope: Same as SteamOS (Not all hardware supports this)
Weston: fullscreen compositor
Weston-W: Same as Weston but Windowed mode
Cage: wlroots fullscreen compositor
Labwc: wlroots compositor (Windowed option)
X11: Useful for some games or hardware
KDE-G: Gamemode (use KDE Desktop to configure settings)
KDE: Full Desktop mode
KDE-X11: Full Desktop mode but in X11

KDE

Logout will bring you back to ControlCenter
If you want to install a 'full' KDE install run: sudo pacman -S kde-applications (then reboot)
To get recomended KDE Virtual keyboard run: yay -S maliit-keyboard
NOTE: Virtual Keybaord "maliit-keyboard" may need to be enabled in settings manually
KDE-G (Use KDE-Desktop to configure settings)
* Set default docking display if using a dock
* Configure VRR or HDR
* Disable Screen-Locks needing a keyboard
* Enable Hide-Cursor after a 5 second delay

Optional Packages

If you need GTK2 for legacy apps / games run: yay -S gtk2 lib32-gtk2

Known Dock Compatability

SABRENT Docking Station for Steam Deck (Stable particularlly with MSI-Claw A1M)
Insignia™ - Rog Ally Docking Station (Stable with most devices)
Ayaneo Multi Station (Stable with Slide/CoreHS & probably others)

General Troubleshooting

WiFi WP3 has issue with Linux atm (use WP2)
If you can't naviage out of something and need to turn the system off:
* Press: Ctrl+Alt+F3
* Enter User: root
* Enter Pass: gamer
* Type: 'poweroff -f' or 'reboot -f'

Power Tuning

Cap FPS to 30fps in Gamescope
Power Profiles: Disable CPU Boosts or lower clocks etc
DeckyTDP: Disable CPU Boosts or lower TDP etc
Force FSR in game settings: gamescope -F fsr --fsr-sharpness 10 -W 1920 -H 1080 -w 1280 -h 720 -- %command%
Force NIS in game settings: gamescope -F nis --sharpness 10 -W 1920 -H 1080 -w 1280 -h 720 -- %command%

Proton Troubleshooting

Linux/Proton Game compatability resource: ProtonDB
If you're getting D3D12 Proton errors try this:
* Switch to experimental Proton (maybe other versions work)
* Set launch options to: "VKD3D_CONFIG=dxr VKD3D_FEATURE_LEVEL=12_2 VKD3D_SHADER_MODEL=6_6 %command%"

GPU Troubleshooting

Launch Control-Center with Cage, X11 or KDE-G:
* Exit to terminal
* Type: nano ReignOS_Launch.sh
* Add the argument '--controlcenter-cage' or '--controlcenter-x11' or '--controlcenter-kde-g' after '--use-controlcenter' arg
* NOTE: '--controlcenter-weston' is default
* Ctrl+X then Y to save
* Type: exit
Change Nvidia drivers without Control-Center:
* Exit to terminal
* Type: cd ~/ReignOS/Managment/ReignOS.Bootloader/bin/Release/net8.0/linux-x64/publish
* Type: './Nvidia_Install_Nouveau.sh' or './Nvidia_Install_Proprietary.sh'
* NOTE: Same for AMD
Disable Steam GPU acceleration in Control-Center can work around some Nvidia issues
If you install Proprietary Nvidia drivers, make sure you see a driver listed in 'GPU Utils'
Some GPU drivers may have issues with MangoHud. (Disable if debugging issues)
Launch Steam in X11, try running a game, then exit. (This can fix Proton issues in Wayland)

Steam Troubleshooting

If Steam is getting stuck on updates
* Launch KDE
* Launch terminal
* Type 'steam' and hit enter
* Each time it stops writing to terminal use KDE to close the update Window in the task bar
* Do this for each Window
* Eventually it should continue to login-screen etc
If Steam Login is having issues on Gamescope, use the Weston, Cage etc compositor instead
Some games don't fully quit until you press the Guide/Xbox button.

Bluetooth Troubleshooting

Xbox Controllers may need their firmware updated from an Xbox or Windows device before they work correctly

Update Troubleshooting

If system is having 'pacman' update issues:
* Go to terminal and type these lines...
* sudo pacman -Sy
* sudo timedatectl set-ntp true
* sudo hwclock --systohc
* COUNTRY=$(curl -s https://ifconfig.co/country-iso)
* sudo reflector --country $COUNTRY --latest 50 --protocol https --sort rate --save /etc/pacman.d/mirrorlist
* sudo pacman -Syyu
* sudo pacman -Sy archlinux-keyring
* sudo pacman-key --init
* sudo pacman-key --populate archlinux
* sudo pacman-key --refresh-keys
* sudo pacman-key --updatedb
* sudo pacman -Syu
* yay -Syu
* reboot
If "Check Updates" button not working or Control-Center not launching
* Go to a terminal
* cd ReignOS/Management
* git pull
* dotnet publish -r linux-x64 -c Release
* exit
Manually connect to WiFi
* iwctl device list (NOTE: this will get you devices like wlan0)
* iwctl station wlan0 scan
* iwctl station wlan0 get-networks
* iwctl station --passphrase '<PASS>' wlan0 connect '<SSID>'

Virtual Box

Virtual Box is not really tested but you should run these commands if you're using it
* sudo pacman -S virtualbox-guest-utils
* sudo modprobe vboxguest
* sudo modprobe vboxsf
* sudo modprobe vboxvideo
* sudo systemctl enable vboxservice.service
* reboot