Files
2026-04-22 21:26:05 -04:00

1.3 KiB

System Updates

Overview

The Stormux Gaming Image uses a read-only root filesystem on x86_64 images, so the System Update option updates managed Stormux files in your home directory. It refreshes the game menu, launcher scripts, installer recipes, documentation, and other files shipped under /home/stormux.

System package updates and root filesystem changes are delivered in new image builds.

How to Update

  1. Open the Game Launcher.
  2. Navigate to System, then Power.
  3. Select System Update.
  4. Wait for the spoken update messages to finish.

The menu restarts automatically after the update so any menu changes are loaded immediately.

What Gets Updated

System Update downloads the latest home/ tree from the Stormux gaming image files repository and applies it to /home/stormux.

The update preserves file permissions, executable bits, and symbolic links from the repository.

Preserved Local Data

The update skips local state and user data, including:

  • .baremetal
  • .cache/
  • .config/stormux/game_launcher.conf
  • .irssi/
  • .local/.services/
  • .local/etc/NetworkManager/
  • .local/games/
  • .local/var/
  • .w3m/
  • Downloads/
  • Logs/

Update Logs

Update output is written to:

~/Logs/system-updates.log

If the update fails, review that file and contact Stormux with the log if you need help.