protonscr

[General] - Steam can fail to restart when the "Home" partition is full.

steamopen Steam client
ValveSoftware/steam-for-linux#11517 · opened 2024-11-26 by ZereoX · updated 2025-07-10 · 1 comments · github
ZZereoX 2024-11-26 github

Your system information

  • Steam client version (build number or date): 1731990050 (Stable) / 1732590255 (Beta)
  • Distribution (e.g. Ubuntu): SteamOS 3.6.20 / 3.7.0 (Deck) and Manjaro w/ Gnome 46 (Desktop)
  • Opted into Steam client beta?: Yes. Issue is present on both Stable and Beta
  • Have you checked for system updates?: Yes
  • Steam Logs: steam-logs.tar.gz
  • GPU: AMD Van Gogh RDNA 2.0 (Steam Deck) and RX 7800XT (Desktop)

Please describe your issue in as much detail as possible:

Most actions that would cause Steam to restart while the Home partition (i.e. /home/deck/) is full can cause it to fail. On Steam Deck this results in the device getting stuck on the Steam throbber with the message Shutting down Steam... or the Steam Deck logo. The device must be power cycled to recover it. In Desktop Mode, when Steam attempts to relaunch the user is instead presented with a Steamwebhelper is not responding error (this behaviour is also reproducible on a Desktop).

The behaviour of the Power Menu options are as follows when the Home partition is full:

  • Broken:
    • Change Account
    • Sign Out
    • Restart Steam
    • Switch to Desktop (KDE fails to launch with its own error messages eventually Steamwebhelper error will be shown).
  • Functional:
    • Sleep
    • Shutdown
    • Restart
Desktop / Desktop Mode Behaviour #​1 Behaviour #​2
Steamwebhelper Shutdown_Stuck deck_logo

Steps for reproducing this issue:

  1. Open the SteamOS Devkit Client.
  2. Select the target device and chose Remote Shell
  3. Run the following command: fallocate -l 500G temp
  4. Navigate to Steam > Power
  5. Select Restart Steam.

Reproduction Rate: 5/5

Affected Platforms

  • LCD / Jupiter: Yes
  • OLED / Galileo: Yes
  • Desktop Deck-like session (gamescope -e -- steam -gamepadui -steamdeck): Yes
  • Desktop: Yes

Actual result

  • Steam Deck hangs during Steam restart and fails to proceed to the expected area. Device must manually be power cycled to recover.
  • On Desktop the user is presented with Steamwebhelper is not responding error prompt. All help options provided do not assist in identifying the root cause or remedy the issue.

Expected result

  • Steam Deck should be able to gracefully fallback to something that would notify the user and allow them to free up space (Desktop mode for example).
  • On Desktop the user is presented with an error message that Steam requires 250MB of space to restart. This would match the behaviour that Steam exhibits during its initial self-update when it is launched for the first time and doesn't have enough space to update.

Notes

  • System Report:
    • LCD: LCD_Restart_Hang.log
    • OLED: OLED_Restart_Hang.log
    • 64GB LCD: 64G_Steam_Restart_Hang.log
      • On a 64GB unit, I observed in one instance that upon power cycling the device the unit got stuck in the Verifying installation... state. The unit had to be power cycled a second time at which point Steam verified the installation in a few seconds and proceeded into SteamOS.
64GB Stuck
64GB_stuck
EErotemic 2025-07-10 github

I had a similar issue on my Ubuntu Linux desktop. When I used the standard gnome method of launching steam I got no message, but when I launched steam via the terminal I got some informative output:

[2025-07-10 13:45:39] Set status message: Verifying installation...
[----] Verifying installation...
[2025-07-10 13:45:39] Fatal error: Steam needs 250MB of free disk space to update.
[----] !!! Fatal Error: Steam needs 250MB of free disk space to update.
[2025-07-10 13:45:40] ProcessNextMessage: socket disconnected
[2025-07-10 13:45:40] No more messages are expected - exiting

For my case, it would be nice if there was a GUI error dialog that told the user about the issue.

Upstream links