Systemd: Frequently Asked Questions (v3.1.0 ) - dlucca1986/SteamMachine-DIY GitHub Wiki

❓ Frequently Asked Questions (v3.1.0+)

[!IMPORTANT] This FAQ is specifically for the Systemd-native version of SteamMachine-DIY.

🛠️ General Questions

1. Why did we move away from SDDM/GDM (Zero-DM)?

Traditional Display Managers (DMs) can conflict with Gamescope's need to claim the primary display socket (:0). By booting directly into the session via systemd units, we achieve:

  • Deterministic Boot: The system starts the session without the overhead of an intermediate login manager.
  • Reliable GPU Handover: Avoids "socket busy" errors when switching between Steam and Desktop.
  • Clean State: Eliminates background X11 processes that can interfere with Wayland performance.

2. Can I use this on NVIDIA GPUs?

The project is currently developed and tested on AMD/Intel (Mesa) hardware. While it may work with nvidia-open drivers, we do not officially support NVIDIA setups. Users with NVIDIA GPUs may experience issues with Gamescope session stability or HDR.

3. How do I access the terminal if the UI is frozen?

Since we don't have a Desktop Environment running behind Steam, use the Linux Virtual Terminals:

  • Press Ctrl + Alt + F2 to switch to TTY2.
  • Login with your username and password.
  • Use our Diagnostic Aliases to debug.

🎮 Gaming & Steam Mode

4. Steam says "Update Error" or "BIOS Update Failed".

This is normal on DIY hardware. We include SteamOS Compatibility Shims (jupiter-biosupdate, steamos-update) that trick the UI. These scripts do nothing but return a "Success" code to keep the Steam UI happy.

5. Why is my resolution stuck at 720p?

You are likely in Safe Mode. This happens if the Watchdog detected a boot failure.

  • Fix: Check your global config at /etc/default/steamos-diy and ensure your monitor supports the target resolution.

6. Does sdy work with non-Steam games?

Yes! If you add a "Non-Steam Game" to your library, you can still use sdy %command% in the launch options to apply per-game prefixes or arguments.

7. Do I need special drivers for my controllers?

Most controllers (Xbox, DualSense, DualShock 4) work out-of-the-box because their drivers are already integrated into the Linux Kernel.

  • Note: We recommend (and include in the installer) the steam-devices package to handle these permissions automatically.

🖥️ Desktop Mode

7. How do I switch to Desktop Mode manually?

If the "Switch to Desktop" button in Steam fails, use the CLI:

steamos-session-select desktop

This will gracefully stop the Gaming session and launch KDE Plasma on TTY1.

8. My Desktop session is laggy or has tearing.

KDE Plasma uses its own compositor (KWin), which operates independently from the Gamescope session. Performance issues in Desktop Mode are usually related to KWin settings or generic driver configurations. Note: The SteamOS-DIY master configuration file only affects the Gaming session; it does not alter Plasma's display behavior.

🔊 Audio & Peripherals

9. Why is there no sound in Gaming Mode?

This project is designed to work with Pipewire. Ensure that pipewire-alsa, pipewire-pulse, and wireplumber are correctly installed and running. Gamescope requires a functional Pipewire stack to route audio correctly.

10. Does Sleep/Wake work like the Steam Deck?

Yes, it uses the standard systemd-suspend logic. Success depends on your hardware's S3 or S0ix (Modern Standby) support. Some third-party USB-C docks may require manual re-connection after wake-up due to kernel-level power management.

🛠️ System & Updates

11. Will a system update (e.g., pacman -Syu) break the DIY setup?

Since we use standard Systemd Units and Agnostic Paths, updates are generally safe. The only thing to watch for is Kernel updates; make sure to rebuild your Early KMS if you change kernels.

12. Where is the main configuration file?

Everything is centralized in one place: sudo nano /etc/default/steamos-diy

⬅️ Back to Home