How to Install

1. Download latest ISO image.
2. Use Balena Etcher to create bootable USB.
3. NOTE: If 'Balena Etcher' fails, use Fedora Media Writer to reset the USB drive, then try again.
4. Disable SecureBoot in your BIOS (Common keys are Esc, F2, Del).
5. If you're Dual-Booting with Windows, disable Windows Bitlocker or resize partitions with Windows DiskManager instead of Gparted.
6. 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.
7. Boot USB using a Dock or USB-Hub if installing on Handheld device.
8. Follow on screen instructions.
9. NOTE: After reboot there will be an extra 'FirstRun' install step (let it fully finish as it can take some time).
10. NOTE: If FirstRun fails, type "exit" and hit enter and it will try again.
11. After installation is finished, its recomended to Sign-In to Steam via KDE first not Gamescope as it gives you more visual feedback.
12. After installation, use KDE to configure extra storage in Steam.
13. NOTE: If Steam is failing to open, you can click the "Reinstall Steam" button in Control-Center.

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

(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.
  1. Right-Click in mounted drive and Open Terminal Here
  2. sudo chown -R gamer:gamer ./
  3. 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.
• Input Control: Choose what system you want to manage input.
  1. ReignOS: No hardware locks or relay and thus low latancy (but may have limitations)
  2. InputPlumber: Supports more buttons on some hardware with relay
  3. HHD: Supports more buttons on some hardware with relay (this may take over TDP and RGB control)
  4. Disabled: Use your own solution or wanted off for PC targets etc
• 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)
  1. Set default docking display if using a dock.
  2. Configure VRR or HDR.
  3. Disable Screen-Locks needing a keyboard.
  4. 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:
  1. Press: Ctrl + Alt + F3
  2. Enter User: root
  3. Enter Pass: gamer
  4. 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:
  1. Switch to experimental Proton (maybe other versions work).
  2. 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:
  1. Exit to terminal.
  2. Type: nano ReignOS_Launch.sh.
  3. Add the argument --controlcenter-cage or --controlcenter-x11 or --controlcenter-kde-g after --use-controlcenter arg.
  4. NOTE: --controlcenter-weston is default.
  5. Ctrl+X then Y to save.
  6. Type: exit.
• Change Nvidia or AMD drivers without Control-Center:
  1. Exit to terminal.
  2. Type: cd ~/ReignOS/Managment/ReignOS.Bootloader/bin/Release/net8.0/linux-x64/publish.
  3. Type: './Nvidia_Install_Nouveau.sh' or './Nvidia_Install_Proprietary.sh'.
  4. NOTE: Same for AMD.
• Nvidia systems that require Proprietary driver to function:
  1. When booting installer, boot with Nouveau disabled
  2. In installer disable Nouveau when installing
  3. After install is complete, apply Proprietary drivers in Control-Center
• Older AMD systems and Vulkan support:
  1. In Control-Center click "Kernel" button
  2. Check the "radeon.cik_support=0 amdgpu.cik_support=1" checkbox and click Apply
  3. After reboot you can validate Vulkan is working using "vkmark" in KDE (it should NOT be llvmpipe)
• 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:
  1. Launch KDE.
  2. Launch terminal.
  3. Type 'steam' and hit enter.
  4. Each time it stops writing to terminal use KDE to close the update Window in the task bar.
  5. Do this for each Window.
  6. 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:
  1. Go to terminal and type these lines...
  2. sudo pacman -Sy
  3. sudo timedatectl set-ntp true
  4. sudo hwclock --systohc
  5. COUNTRY=$(curl -s https://ifconfig.co/country-iso)
  6. sudo reflector --country $COUNTRY --latest 50 --protocol https --sort rate --save /etc/pacman.d/mirrorlist
  7. sudo pacman -Syyu
  8. sudo pacman -Sy archlinux-keyring
  9. sudo pacman-key --init
  10. sudo pacman-key --populate archlinux
  11. sudo pacman-key --refresh-keys
  12. sudo pacman-key --updatedb
  13. sudo pacman -Syu
  14. yay -Syu
  15. reboot
• If "Check Updates" button not working or Control-Center not launching:
  1. Go to a terminal
  2. cd ReignOS/Management
  3. git pull
  4. dotnet publish -r linux-x64 -c Release
  5. exit
• Manually connect to WiFi:
  1. iwctl device list (NOTE: this will get you devices like wlan0)
  2. iwctl station wlan0 scan
  3. iwctl station wlan0 get-networks
  4. 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:
  1. sudo pacman -S virtualbox-guest-utils
  2. sudo modprobe vboxguest
  3. sudo modprobe vboxsf
  4. sudo modprobe vboxvideo
  5. sudo systemctl enable vboxservice.service
  6. reboot